Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Staking

Get staked account rewards - Batch

/v4/data/staking/native/rewards/batch

100 credits per stake address per API call

Get historical staking rewards for up to 50 stake accounts in a single request. Returns the same per-address shape as /staking/native/rewards, one entry per input address, in input order.

Supported blockchains:

  • Solana - solana-mainnet (optional epoch/block/time filters)

To get started:

  • POST a JSON body with chain, an array of 1–50 unique stakeAddresses, and (optionally) shared filters.
  • All filters are shared across all addresses in the request. Filter semantics match the single endpoint (epoch/block/time/unix; only one filter type at a time).
  • The response is an array preserving input order; duplicate input addresses are rejected by validation.
  • Each item has the same shape as the single endpoint response (stakeAddress, totalAmount, rewards[]). Rewards inside each item are sorted by epoch descending.
post/v4/data/staking/native/rewards/batch

Request body

chain'solana-mainnet' required

The blockchain to query. Only Solana mainnet is supported for batch.

stakeAddressesstring[] required

List of stake account addresses to query (1–50 unique entries).

epochFromnumber

Filter rewards from this epoch (inclusive). Only one filter type may be used per request.

epochTonumber

Filter rewards to this epoch (inclusive). Only one filter type may be used per request.

blockFromnumber

Filter rewards from this block number (inclusive). Only one filter type may be used per request.

blockTonumber

Filter rewards to this block number (inclusive). Only one filter type may be used per request.

timeFromstring date-time

Filter rewards from this date (inclusive, ISO 8601). Only one filter type may be used per request.

timeTostring date-time

Filter rewards to this date (inclusive, ISO 8601). Only one filter type may be used per request.

unixFromnumber

Filter rewards from this unix timestamp (inclusive). Only one filter type may be used per request.

unixTonumber

Filter rewards to this unix timestamp (inclusive). Only one filter type may be used per request.

Example request

{
  "chain": "solana-mainnet",
  "stakeAddresses": [
    "8JMUtSoHS3h28tL7AJHP1SbXfhfeZSnpJ1hWZNCMSw9G",
    "43wKrYJ8jd2k5GpbiH31oaEYHohc4GBFKYqXRtdyf2Ye"
  ],
  "epochFrom": 870,
  "epochTo": 872,
  "blockFrom": 376272225,
  "blockTo": 377136045,
  "timeFrom": "2024-01-01T00:00:00Z",
  "timeTo": "2024-12-31T23:59:59Z",
  "unixFrom": 1704067200,
  "unixTo": 1735689599
}

Response

OK

stakeAddressstring required

The stake account address.

totalAmountstring required

Total rewards amount in SOL.

Example response

[
  {
    "stakeAddress": "8JMUtSoHS3h28tL7AJHP1SbXfhfeZSnpJ1hWZNCMSw9G",
    "totalAmount": "1234.567890123",
    "rewards": [
      {
        "epoch": 873,
        "blockNumber": 377568231,
        "amount": "230.858942334",
        "postBalance": "677185.048123885"
      }
    ]
  }
]