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

Get validator balances from state

Provides a list of validator balances that can be filtered.

For each index or public key that matches a recognized validator, balances will be returned. No balance will be returned in the event that an index or public key does not match any known validator; nevertheless, this won't result in an error. The index, which is provided for each balance but cannot be used to verify which inputs have received a response, does not guarantee the ordering of the data that is returned.

Example Request and Result for /v1/beacon/states/{state_id}/validator_balances

In this section, we provide an illustrative example of a request made to retrieve details contents using the /v1/beacon/states/{state_id}/validator_balances endpoint. Additionally, we present the resulting response containing information about validator's balances.

Parameters

Field	Type	Description
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
id	array<string>	Either hex encoded public key (any bytes48 with 0x prefix) or validator index

The example in this section uses a non-existing project id.

Make sure you replace it with your Ethereum Holesky Beacon endpoint when issuing the API calls.

Don't have a project id? Here's a straightforward guide on how to obtain one!

Get validator balances from state

GET https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/states/{state_id}/validator_balances

Path Parameters

Name	Type	Description
state_id*	String	head

Query Parameters

Name	Type	Description
id	array<string>	1528579

200: OK Expand for a detailed response example

{
  "execution_optimistic": true,
  "finalized": false,
  "data": [
    {
      "index": "1528579",
      "balance": "32000172298"
    }
  ]
}

Curl Request example

curl -X 'GET' \
  'https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/states/head/validator_balances?id=1528579' \
  -H 'accept: application/json'