Get a Stream of Rewards for a Single Address

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.

API Parameters

network

• Type: string
• Required: Yes
• Description: The network to look up against. Defaults to mainnet.

type

• Type: string
• Enum: delegator, validator
• Required: Yes
• Description: Specifies the role associated with the request.

address

• Type: string
• Required: Yes
• Description: The address to look up rewards for.

startTime

• Type: number
• Required: Yes
• Description: Epoch-based start time for reward queries.

endTime

• Type: number
• Required: Yes
• Description: Epoch-based end time for reward queries.

period

• Type: string
• Enum: raw, daily, weekly, monthly
• Required: Yes
• Description: The type of aggregation to apply.

accept

• Type: string
• Enum: application/json, application/x-ndjson
• Default: application/json
• Description: Generated from available response content types.

Example cURL Request

curl --request GET \
     --url 'https://svc.blockdaemon.com/reporting/staking/v2/cosmos/mainnet/delegator/rewards/address?period=raw' \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json'

Response Codes

• 200 OK
• 400 Bad Request
• 422 Validation Error