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

Get validators from state

Get validators from state

get

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.

Path parameters

state_idstringRequired

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

idstring[] · max: 30Optional

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

Responses

200

Success

application/json

400

Invalid state or validator ID, or status

application/json

404

State not found

application/json

500

Beacon node internal error.

application/json

get

HTTPcURLJavaScriptPython

GET /v1/<YOUR_API_KEY_HERE>//eth/v1/beacon/states/{state_id}/validators HTTP/1.1
Host: mainnet.ethereum.validationcloud.io
Accept: */*

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

Mainnet

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

Testnet

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