Get validation round metadata

Returns past and current validation rounds with boundaries, stakes, and bonuses. Always uses the latest masterchain block.

get/v2/rewards/validation-rounds

Request

Base URL
https://tonapi.io
Auth
none declared
TypeScript
https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/docs/v2/rewards/validation-rounds/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

election_idinteger

Return the single round matching this election ID. Mutually exclusive with block and unixtime.

blockinteger

Find the round containing this masterchain block seqno and return it plus up to limit-1 older rounds. 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.

Response

Successful response

response_time_msinteger required

Server-side response time in milliseconds.

Example response

{
  "response_time_ms": 1234,
  "rounds": [
    {
      "bonuses": 123456789,
      "election_id": 1740053384,
      "end_block": 57546000,
      "end_utime": 23814011000000,
      "finished": true,
      "next_election_id": 1772658824,
      "prev_election_id": 1772486024,
      "start_block": 57480000,
      "start_utime": 23814011000000,
      "total_stake": 123456789
    }
  ]
}

Changes

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