/v1/beacon/states/{state_id}/validator_balances
GET
https://eth-mainnetbeacon.g.alchemy.com/v2/docs-demo/eth/v1/beacon/states/{state_id}/validator_balances
Returns a filterable list of validator balances. Balances will be returned for all indices or public keys 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. The response does not guarantee ordering, so the index should be used to match inputs.
Path Parameters
stringrequired
State identifier. Can be one of: head (canonical head in node's view), genesis, finalized, justified, <slot>, <hex encoded stateRoot with 0x prefix>.
Query Parameters
string[]optional
Optional filter: hex-encoded validator public key (bytes48 with 0x prefix) or validator index. Multiple values can be provided.
Responses
200
Validator balances for the given state.
Was this page helpful?