1 of 1

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

Get validators from state

curl -X GET \
    "curl https://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>/eth/v1/beacon/states/head/validators?status=active \
    -H "Content-Type: application/json"

curl -X GET \
    "curl https://sepolia.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>/eth/v1/beacon/states/head/validators?status=active \
    -H "Content-Type: application/json"

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

Get validators from state

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

Information will be returned for all indices or public key that match known validators. If an index or public key does not match any known validator, no information will be returned but this will not cause an error. There are no guarantees for the returned data in terms of ordering; both the index and public key are returned for each validator, and can be used to confirm for which inputs a response has been returned.

GEThttps://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>//eth/v1/beacon/states/{state_id}/validators

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Example: "head"

Query parameters

idarray of string

Either hex encoded public key (any bytes48 with 0x prefix) or validator index

itemsstring

Either hex encoded public key (any bytes48 with 0x prefix) or validator index

statusarray of all of

Validator status specification

enum

Possible statuses:

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 status specification

Example: "active_ongoing"

pending_initializedpending_queuedactive_ongoingactive_exitingactive_slashedexited_unslashedexited_slashedwithdrawal_possiblewithdrawal_done

enum

activependingexitedwithdrawal

Response

Success

Body

execution_optimisticall of

boolean

any

Example: false

any

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.

dataarray of object

indexall of

string

Example: "1"

any

Index of validator in validator registry.

balanceall of

string

Example: "1"

any

Current validator balance in gwei.

statusenum

Possible statuses:

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 status specification

Example: "active_ongoing"

pending_initializedpending_queuedactive_ongoingactive_exitingactive_slashedexited_unslashedexited_slashedwithdrawal_possiblewithdrawal_done

validatorobject

pubkeystring

The validator's BLS public key, uniquely identifying them. 48-bytes, hex encoded with 0x prefix, case insensitive.

Example: "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a"

Pattern: ^0x[a-fA-F0-9]{96}$

withdrawal_credentialsall of

string

Example: "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"

Pattern: ^0x[a-fA-F0-9]{64}$

any

Root of withdrawal credentials

effective_balanceall of

string

Example: "1"

any

Balance at stake in Gwei.

slashedboolean

Was validator slashed (not longer active).

Example: false

activation_eligibility_epochall of

string

Example: "1"

any

When criteria for activation were met.

activation_epochall of

string

Example: "1"

any

Epoch when validator activated. 'FAR_FUTURE_EPOCH' if not activated

exit_epochall of

string

Example: "1"

any

Epoch when validator exited. 'FAR_FUTURE_EPOCH' if not exited.

withdrawable_epochall of

string

Example: "1"

any

When validator can withdraw or transfer funds. 'FAR_FUTURE_EPOCH' if not defined

Request

Response

curl -X GET \
    "curl https://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>/eth/v1/beacon/states/head/validators?status=active \
    -H "Content-Type: application/json"

curl -X GET \
    "curl https://sepolia.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>/eth/v1/beacon/states/head/validators?status=active \
    -H "Content-Type: application/json"

Get validators from state

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

GEThttps://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>//eth/v1/beacon/states/{state_id}/validators

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Example: "head"

Query parameters

idarray of string

Either hex encoded public key (any bytes48 with 0x prefix) or validator index

itemsstring

Either hex encoded public key (any bytes48 with 0x prefix) or validator index

statusarray of all of

Validator status specification

enum

Possible statuses:

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 status specification

Example: "active_ongoing"

pending_initializedpending_queuedactive_ongoingactive_exitingactive_slashedexited_unslashedexited_slashedwithdrawal_possiblewithdrawal_done

enum

activependingexitedwithdrawal

Response

Success

Body

execution_optimisticall of

boolean

any

Example: false

any

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.

dataarray of object

indexall of

string

Example: "1"

any

Index of validator in validator registry.

balanceall of

string

Example: "1"

any

Current validator balance in gwei.

statusenum

Possible statuses:

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 status specification

Example: "active_ongoing"

pending_initializedpending_queuedactive_ongoingactive_exitingactive_slashedexited_unslashedexited_slashedwithdrawal_possiblewithdrawal_done

validatorobject

pubkeystring

The validator's BLS public key, uniquely identifying them. 48-bytes, hex encoded with 0x prefix, case insensitive.

Example: "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a"

Pattern: ^0x[a-fA-F0-9]{96}$

withdrawal_credentialsall of

string

Example: "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"

Pattern: ^0x[a-fA-F0-9]{64}$

any

Root of withdrawal credentials

effective_balanceall of

string

Example: "1"

any

Balance at stake in Gwei.

slashedboolean

Was validator slashed (not longer active).

Example: false

activation_eligibility_epochall of

string

Example: "1"

any

When criteria for activation were met.

activation_epochall of

string

Example: "1"

any

Epoch when validator activated. 'FAR_FUTURE_EPOCH' if not activated

exit_epochall of

string

Example: "1"

any

Epoch when validator exited. 'FAR_FUTURE_EPOCH' if not exited.

withdrawable_epochall of

string

Example: "1"

any

When validator can withdraw or transfer funds. 'FAR_FUTURE_EPOCH' if not defined

Request

Response

const response = await fetch('https://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>//eth/v1/beacon/states/{state_id}/validators', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

{
  "execution_optimistic": {},
  "data": [
    {
      "index": {},
      "balance": {},
      "status": "active_ongoing",
      "validator": {
        "pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a",
        "withdrawal_credentials": {},
        "effective_balance": {},
        "slashed": false,
        "activation_eligibility_epoch": {},
        "activation_epoch": {},
        "exit_epoch": {},
        "withdrawable_epoch": {}
      }
    }
  ]
}