TOtonapi
Rewards

Get all current validators

Returns all current validators with stakes, rewards, pool addresses, and (optionally) nominator breakdowns.

get/v2/rewards/validators

Request

Query parameters

seqnointeger

Masterchain block seqno. Defaults to latest. Mutually exclusive with unixtime.

unixtimeinteger

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

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

Current election ID (electAt timestamp).

elector_balanceinteger required

amount in nanograms

next_election_idinteger

Election ID of the round immediately after this one. Omitted when the current round is not yet finished (next round not known).

prev_election_idinteger

Election ID of the round immediately before this one.

response_time_msinteger required

Server-side response time in milliseconds.

reward_per_blockinteger required

amount in nanograms

total_stakeinteger required

amount in nanograms

Example response

{
  "block": {
    "seqno": 57486221,
    "utime": 23814011000000
  },
  "election_id": 1740053384,
  "elector_balance": 123456789,
  "next_election_id": 1772658824,
  "prev_election_id": 1772486024,
  "response_time_ms": 12345,
  "reward_per_block": 123456789,
  "total_stake": 123456789,
  "validation_round": {
    "end_block": 57546000,
    "end_utime": 23814011000000,
    "start_block": 57480000,
    "start_utime": 23814011000000
  },
  "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.