v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

Cosmos Staking Reporting

Get a Stream of Rewards

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

post/v2/cosmos/{network}/{type}/rewards

networkstring required

the network to look up against

type'delegator' | 'validator' required

Specifies the role associated with the request.

startTimenumber required

Epoch-based start time for reward queries.

endTimenumber required

Epoch-based end time for reward queries.

addressesstring[] required

List of addresses to retrieve rewards for.

period'raw' | 'daily' | 'weekly' | 'monthly'

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

aggregateboolean

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

{
  "startTime": 1709251200,
  "endTime": 1711929600,
  "addresses": [
    "cosmosvaloper10nzaaeh2kq28t3nqsh5m8kmyv90vx7ym5mpakx"
  ]
}