Get a Stream of Rewards

Please Note

• Rewards payouts are based on complete UTC days, with one entry per validator/delegator each day.
• A minimum delegation of 100 ATOM is required to start tracking a delegator.
• Data is available only from May 1, 2025, onward.

Network

• Type: string (required)
• Defaults to mainnet
• Description: The network to look up against

Type

• Type: string (enum) (required)
• Description: Specifies the role associated with the request.
• Allowed values: delegator, validator

Start Time

• Type: number (required)
• Description: Epoch-based start time for reward queries.

End Time

• Type: number (required)
• Description: Epoch-based end time for reward queries.

Addresses

• Type: array of strings (required)
• Description: List of addresses to retrieve rewards for.

Period

• Type: string (enum)
• Description: How the data is aggregated;
• Allowed values: raw, daily, weekly, monthly

Aggregate

• Type: boolean
• Defaults to false
• Description: Whether to aggregate across provided addresses or per address - true to aggregate across all addresses

Accept

• Type: string (enum)
• Defaults to application/json
• Description: Generated from available response content types
• Allowed values: application/json, application/x-ndjson

Response Codes

• 200 OK
• 400 Bad Request
• 422 Validation Error

Example cURL Request

curl --request POST \
     --url https://svc.blockdaemon.com/reporting/staking/v2/cosmos/mainnet/delegator/rewards \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"aggregate":false}'

Response Examples

• application/x-ndjson
• 200
• application/json
• 400
• 422