Get a Stream of Rewards

post

https://svc.blockdaemon.com/reporting/staking/v2/cosmos/{network}/{type}/rewards

Returns 0 or more reward objects in a streaming fashion using ndjson.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

❗️
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.

Path Params

network

string

required

Defaults to mainnet

the network to look up against

type

string

enum

required

Specifies the role associated with the request.

Allowed:

Body Params

startTime

number

required

Epoch-based start time for reward queries.

endTime

number

required

Epoch-based end time for reward queries.

addresses

array of strings

required

List of addresses to retrieve rewards for.

addresses*

period

string

enum

How the data is aggregated, raw is checkpoint level data.

Allowed:

aggregate

boolean

Defaults to false

Whether to aggregate across provided addresses or per address - true to aggregate across all addresses

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Choose an example:

application/x-ndjson

application/json

Please Note

200OK

400Bad Request

422Validation Error