Score staking reward fairness API

Compare each supplied allocation with the share of the reward pool its weight implies. The rounding error is the total absolute gap, divided by the reward. Equal weights with uneven payouts lower the fairness score. No reward balance is fetched.

The Score staking reward fairness operation is part of the Staking Reward Allocation API on BRAINIAC.software. Compare each supplied allocation with the share of the reward pool its weight implies. The rounding error is the total absolute gap, divided by the reward. Equal weights with uneven payouts lower the fairness score. No reward balance is fetched. It is exposed as POST /api/v1/staking-operations/reward-fairness and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied staking reward allocations processed locally Limitations: Amounts are integers in the caller-supplied smallest unit. No reward balance is fetched. Commission and shares use only the percents, penalties, and rounding rule in the request. Expected allocations are calculated. Actual amounts come only from distribution records in the request. This is not an invoice or stablecoin payment reconciliation. reward-fairness compares allocations with weight. It does not fetch a reward balance. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Audit staking reward allocation. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.04 USDC
/api/v1/staking-operations/reward-fairness

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/staking-operations/reward-fairness" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "reward": 1000,
  "shares": [
    {
      "id": "a",
      "weight": 1,
      "allocated": 400
    },
    {
      "id": "b",
      "weight": 1,
      "allocated": 300
    },
    {
      "id": "c",
      "weight": 1,
      "allocated": 300
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Staking Reward Allocation APIFull docsHow it works