Skip to main content

/api/validators REST API Endpoint

Returns all current validators with stakes, rewards, pool addresses, and nominators.

Updated on
Apr 02, 2026

Query Parameters

seqno
integer

Masterchain block seqno. Defaults to latest if not provided

Returns

response_time_ms
integer

Server-side response time in milliseconds

block
object

The masterchain block information

seqno
integer

Masterchain block sequence number

time
string

Block timestamp (UTC, RFC 3339)

validation_round
object

The current validation round details

start
string

Current validation round start time (UTC, RFC 3339)

end
string

Current validation round end time (UTC, RFC 3339)

start_block
integer

The masterchain block seqno at the start of the round

end_block
integer

The masterchain block seqno at the end of the round. Only present for finished rounds

election_id
integer

The election ID of the current validation round

prev_election_id
integer

The election ID of the previous validation round. Only present when available

next_election_id
integer

(Optional) The election ID of the next validation round. Only present when available

elector_balance
string

Elector contract balance (nanoTON)

total_stake
string

Sum of all active validators' effective stakes (nanoTON)

reward_per_block
string

Total fees collected in the target block (nanoTON)

validators
array

An array of validator objects

rank
integer

Position in the validator list, sorted by effective stake (descending)

pubkey
string

Validator's public key (hex-encoded Ed25519)

effective_stake
string

Validator's true stake locked in the Elector contract (nanoTON)

weight
number

Fraction of the total effective stake held by this validator (0-1)

reward
string

Estimated reward this validator earns per masterchain block (nanoTON)

pool
string

Pool smart contract address (bounceable, base64url). Only present when a pool is associated

owner_address
string

The single owner who deposited funds (bounceable, base64url). Only present for single-nominator pools

validator_address
string

Validator's wallet address that controls the node (bounceable, base64url). Only present for nominator and single-nominator pools

pool_type
string

Contract type: nominator-pool-v1.0, single-nominator-pool-v1.0, single-nominator-pool-v1.1, or other

validator_stake
string

Validator's own funds deposited into the pool (nanoTON). Only present for nominator pools

nominators_stake
string

Sum of all nominator deposits in the pool (nanoTON). Only present for nominator pools

total_stake
string

Total funds deposited by the pool (nanoTON)

validator_reward_share
number

Fraction of staking rewards kept by the validator (e.g., 0.3 = 30%). Only present for nominator pools

nominators_count
integer

Number of nominators in the pool. Only present for nominator pools

nominators
array

List of individual nominators. Only present for nominator pools

address
string

Nominator's wallet address (bounceable, base64url)

weight
number

Nominator's share of the total nominators' deposit (0-1)

reward
string

Estimated per-block reward after the validator's cut (nanoTON)

effective_stake
string

Nominator's proportional share of the effective stake locked in the Elector (nanoTON)

stake
string

Nominator's raw deposit in the pool contract (nanoTON)

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free