Sign in

v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB
Polkadot Staking Reporting

Get a List of Stake & Rewards for Multiple Nominators

Returns the current stake & rewards allocated by a user-defined list of nominator addresses.

post/v1/polkadot/mainnet/nominator/rewards

Query parameters

aggregateboolean

Set to true for the rewards to be aggregated across addresses.

Request body

addressesstring[]

A list of addresses.

Response

List of Stake & Rewards for Multiple Nominators

addressstring required

The public address.

currencystring required

The cryptocurrency protocol the request relates to.

returnnumber float required

The sum of the rewards for the previous UTC day. Rewards are recorded per session (four hours on Polkadot), and calculated per era (twenty-four hours on Polkadot). Thus, rewards will be calculated once per day on Polkadot.

timeStartstring required

The timestamp, in UTC, that marks the start of the period covered.

timeEndstring required

The timestamp, in UTC, that marks the end of the period covered.

timeAggregationstring required

The agregation period, one of era, day, week, or month.

startingBalancenumber float required

The staked amount at the beginning of the previous UTC day (at the timeStart).