Get a Stream of Yield Summaries

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.

Parameters

network

• Type: string
• Required: Yes
• Description: The blockchain network to query (e.g., mainnet).

type

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

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.

denomination

• Type: string
• Default: uatom
• Description: The unit to return the yield in.

raw

• Type: boolean
• Default: false
• Description: Gives the yield values raw per-epoch. Set to true to get per-epoch raw values.

Accept

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

Response Codes

• 200
• 400
• 422

Example Request

curl --request GET \
     --url 'https://svc.blockdaemon.com/reporting/staking/v2/cosmos/mainnet/delegator/yield?denomination=uatom&raw=false' \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json'

Choose an example:

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