TOtonapi
Rewards

Get per-validator reward distribution for a finished round

Computes per-validator and per-nominator reward distribution for a finished validation round using the elector's bonuses value.

get/v2/rewards/round-rewards

Request

Query parameters

election_idinteger

Election ID of the finished round. Mutually exclusive with block and unixtime.

blockinteger

Masterchain block seqno within the finished round. Mutually exclusive with election_id and unixtime.

unixtimeinteger

Unix timestamp (seconds). Looks up the masterchain block at this time and uses it as the anchor. Mutually exclusive with election_id and block.

shallowboolean

Set to 1 to return only basic validator info (rank, pubkey, effective_stake, weight, reward, pool). Skips pool type detection, owner/validator addresses, nominator data, and returned-stake lookup — significantly faster.

Response

Successful response

election_idinteger required

Election ID (electAt timestamp).

end_blockinteger required

Last masterchain block of the round.

errorstring
next_election_idinteger

Election ID of the round immediately after this one.

prev_election_idinteger

Election ID of the round immediately before this one.

response_time_msinteger required

Server-side response time in milliseconds.

round_endstring date-time required

Validation round end time.

round_startstring date-time required

Validation round start time.

start_blockinteger required

First masterchain block of the round.

total_bonusesinteger required

amount in nanograms

total_stakeinteger required

amount in nanograms

Example response

{
  "election_id": 1740053384,
  "next_election_id": 1772658824,
  "prev_election_id": 1772486024,
  "response_time_ms": 5432,
  "total_bonuses": 123456789,
  "total_stake": 123456789,
  "validators": [
    {
      "effective_stake": 123456789,
      "nominators": [
        {
          "address": "EQAqR4RYauq7p3jqKGnD-eSYVDoOCak9g8ZsSNVHI9fevCzB",
          "effective_stake": 123456789,
          "reward": 123456789,
          "stake": 123456789,
          "weight": 0.15
        }
      ],
      "nominators_stake": 123456789,
      "pool": "Ef_bmCmMPsrHKOC4hV8foWBs2TEUAggQ1Wfe6EAqjrI3sGNI",
      "public_key": "e33f0e53552f951e0a27c8e5a461a1bd65975af369a2c85a06e51f7fbb8ae667",
      "rank": 1,
      "reward": 123456789,
      "total_stake": 123456789,
      "validator_reward_share": 0.3,
      "validator_stake": 123456789,
      "weight": 0.004648
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.