Audit staking reward allocation API
Calculate staking reward allocations from the supplied commission percent, share percents, penalties, and rounding rule. Share percents must sum to 100%. Commission is that percent of gross rewards or of rewards after penalties. audit_status is balanced, mismatched, invalid, or incomplete. Expected amounts are calculated. Actual amounts come only from distribution records in the request. No staking reward is fetched, and this is not an invoice or stablecoin reconciliation.
The Audit staking reward allocation operation is part of the Staking Reward Allocation API on BRAINIAC.software. Calculate staking reward allocations from the supplied commission percent, share percents, penalties, and rounding rule. Share percents must sum to 100%. Commission is that percent of gross rewards or of rewards after penalties. audit_status is balanced, mismatched, invalid, or incomplete. Expected amounts are calculated. Actual amounts come only from distribution records in the request. No staking reward is fetched, and this is not an invoice or stablecoin reconciliation. It is exposed as POST /api/v1/staking-operations/staking-reward-allocation-audit and priced at $0.05 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 Score staking reward fairness. Open the group documentation for the full request schema, field notes, and response examples before integrating.
/api/v1/staking-operations/staking-reward-allocation-auditExample request
curl -i -X POST "https://www.brainiac.software/api/v1/staking-operations/staking-reward-allocation-audit" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"periods": [
{
"id": "2026-01",
"validator": "validator-a",
"totalRewards": "1100",
"start": "2026-01-01T00:00:00Z",
"end": "2026-02-01T00:00:00Z",
"deductions": [
{
"id": "offline-penalty",
"amount": "100"
}
],
"commission": {
"beneficiary": "operator-a",
"percent": "10",
"basis": "net_after_deductions"
},
"statedCommission": "90",
"shares": [
{
"beneficiary": "delegator-a",
"role": "delegator",
"percent": "50"
},
{
"beneficiary": "delegator-b",
"role": "delegator",
"percent": "50"
}
],
"rounding": "floor",
"remainder": "undistributed"
},
{
"id": "2026-02",
"validator": "validator-b",
"totalRewards": "100",
"commission": {
"beneficiary": "operator-b",
"percent": "10",
"basis": "gross"
},
"shares": [
{
"beneficiary": "delegator-c",
"role": "delegator",
"percent": "33.3334"
},
{
"beneficiary": "delegator-d",
"role": "delegator",
"percent": "33.3333"
},
{
"beneficiary": "delegator-e",
"role": "delegator",
"percent": "33.3333"
}
],
"rounding": "floor",
"remainder": "undistributed"
}
],
"distributions": [
{
"periodId": "2026-01",
"beneficiary": "operator-a",
"amount": "100",
"at": "2026-01-15T00:00:00Z"
},
{
"periodId": "2026-01",
"beneficiary": "delegator-a",
"amount": "400"
}
]
}
JSONAn 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 operations
- Score staking reward fairness — $0.04 USDC