Skip to main content

/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

FieldTypeDescription
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

idarray<string>Either hex encoded public key (any bytes48 with 0x prefix) or validator index
info

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!

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'