Get a Stream of Rewards

Network

• String (required): Defaults to mainnet. The network to look up against.

Type

• String (enum, required): Specifies whether the request is for a validator or delegator.
  • Allowed: validator, delegator

Start Time

• Number: Defaults to 1709251200. Epoch-based start time for reward queries.

End Time

• Number: Defaults to 1711929600. Epoch-based end time for reward queries.

Epoch

• Number: Defaults to 755. The epoch.

Addresses

• Array of strings (required): Defaults to FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571. List of addresses to retrieve rewards for.

Period

• String (enum): Defaults to monthly. How the data is aggregated; raw is checkpoint level data.
  • Allowed: yearly, daily, weekly, monthly, epoch, raw

Aggregate

• Boolean: Defaults to false. Whether to aggregate across provided addresses or per address - true to aggregate across all addresses.
  • Allowed: true, false

Denomination

• String (enum): Defaults to lamports. The denomination to return rewards in.
  • Allowed: lamports, sol

Accept

• String (enum): Defaults to application/json. Generated from available response content types.
  • Allowed: application/json, application/x-ndjson

Example API Request

curl --request POST \
     --url https://svc.blockdaemon.com/reporting/staking/v2/solana/mainnet/validator/rewards \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "startTime": 1709251200,
  "endTime": 1711929600,
  "epoch": 755,
  "addresses": [ "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571" ],
  "period": "monthly",
  "aggregate": false,
  "denomination": "lamports"
}
'```

## Status Codes
- **200**: OK
- **400**: Bad Request
- **422**: Validation Error

---