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

Get validator balances from state

Get validator balances from state

Returns filterable list of validators balances.

Balances 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 balance will be returned but this will not cause an error. There are no guarantees for the returned data in terms of ordering; the index and is returned for each balance, 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}/validator_balances

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

Response

200400500

Success

Body

application/json

execution_optimisticall of

dataarray of object

Request

JavaScriptCurlPython

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

Response

200400500

{
  "execution_optimistic": {},
  "data": [
    {
      "index": {},
      "balance": {}
    }
  ]
}

Mainnet

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

Testnet

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