Links

/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
https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/states/{state_id}/validator_balances
Get validator balances from state
Parameters
Path
state_id*
head
Query
id
array<string>
1528579
Responses
200: OK
Expand for a detailed response example

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'