Skip to main content

/eth/v1/beacon/states/{state_id}/validators RPC Method

Returns a filterable list of validators with their balance, status and index.

Updated on
Oct 4, 2023

/eth/v1/beacon/states/{state_id}/validators RPC Method

Parameters

state_id
string
REQUIRED
The state identifier. It can be one of: head (canonical head in node's view), genesis, finalized, justified, slot and stateRoot (hex encoded stateRoot with 0x prefix)
id
array
Either hex encoded public key (any bytes48 with 0x prefix) or validator index
status
array
Validator status specification

Returns

execution_optimistic
boolean
True if the response references an unverified execution payload. Optimistic information may be invalidated at a later time. If the field is not present, assume the false value
data
The object with the following fields:
index
string
The index of validator in validator registry
balance
string
The current validator balance in gwei
status
String
The type of possible status values:
pending_initialized
When the first deposit is processed, but not enough funds are available (or not yet the end of the first epoch) to get validator into the activation queue
pending_queued
When validator is waiting to get activated, and have enough funds etc. while in the queue, validator activation epoch keeps changing until it gets to the front and make it through (finalization is a requirement here too)
active_ongoing
When validator must be attesting, and have not initiated any exit
active_exiting
When validator is still active, but filed a voluntary request to exit
active_slashed
When validator is still active, but have a slashed status and is scheduled to exit
exited_unslashed
When validator has reached reguler exit epoch, not being slashed, and doesn't have to attest any more, but cannot withdraw yet
exited_slashed
When validator has reached reguler exit epoch, but was slashed, have to wait for a longer withdrawal period
withdrawal_possible
After validator has exited, a while later is permitted to move funds, and is truly out of the system
withdrawal_done
(not possible in phase0, except slashing full balance) actually having moved funds away
validator
The object with the following fields:
pubkey
string
The validator's BLS public key, uniquely identifying them. _48-bytes, hex encoded with 0x prefix, case insensitive
withdrawal_crendetials
String
The root of withdrawal credentials
effective_balance
String
The balance at stake in Gwei
slashed
String
Was validator slashed (not longer active)
activation_elgibility_epoch
String
When criteria for activation were met
activation_epoch
String
Epoch when validator activated. FAR_FUTURE_EPOCH if not activated
exit_epoch
String
Epoch when validator exited
withdrawable_epoch
String
When validator can withdraw or transfer funds. FAR_FUTURE_EPOCH if not defined
Request
1
curl -X GET \
2
    "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validators?status=active" \
3
    -H "accept: application/json"
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free