Get per-validator reward distribution for a finished round

{ "response_time_ms": 5432, "election_id": 1740053384, "round_start": "2023-11-07T05:31:56Z", "round_end": "2023-11-07T05:31:56Z", "start_block": 123, "end_block": 123, "total_bonuses": 123456789, "total_stake": 123456789, "validators": [ { "rank": 1, "public_key": "e33f0e53552f951e0a27c8e5a461a1bd65975af369a2c85a06e51f7fbb8ae667", "effective_stake": 123456789, "weight": 0.004648, "reward": 123456789, "pool": "Ef_bmCmMPsrHKOC4hV8foWBs2TEUAggQ1Wfe6EAqjrI3sGNI", "pool_type": "nominator-pool-v1.0", "owner_address": "<string>", "validator_address": "<string>", "validator_stake": 123456789, "nominators_stake": 123456789, "total_stake": 123456789, "validator_reward_share": 0.3, "nominators_count": 123, "nominators": [ { "address": "EQAqR4RYauq7p3jqKGnD-eSYVDoOCak9g8ZsSNVHI9fevCzB", "weight": 0.15, "reward": 123456789, "effective_stake": 123456789, "stake": 123456789 } ] } ], "prev_election_id": 1772486024, "next_election_id": 1772658824, "error": "<string>" }

Query Parameters

election_id

integer<int64>

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

block

integer<uint32>

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

unixtime

integer<uint32>

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

shallow

boolean

default:false

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

response_time_ms

integer<int64>

required

Server-side response time in milliseconds.

Example:

5432

election_id

integer<int64>

required

Election ID (electAt timestamp).

Example:

1740053384

round_start

string<date-time>

required

Validation round start time.

round_end

string<date-time>

required

Validation round end time.

start_block

integer<uint32>

required

First masterchain block of the round.

end_block

integer<uint32>

required

Last masterchain block of the round.

total_bonuses

integer<int64>

required

amount in nanograms

Example:

123456789

total_stake

integer<int64>

required

amount in nanograms

Example:

123456789

validators

object[]

required

Show child attributes

prev_election_id

integer<int64>

Election ID of the round immediately before this one.

Example:

1772486024

next_election_id

integer<int64>

Election ID of the round immediately after this one.

Example:

1772658824

error

string

REST API

Webhooks

Streaming

Get per-validator reward distribution for a finished round

Query Parameters

Response