/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
state_id
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
id
Optional filter: hex-encoded validator public key (bytes48 with 0x prefix) or validator index. Multiple values can be provided.
Response
Validator balances for the given state.
execution_optimistic
Whether the execution payload is optimistic.
finalized
Whether the state is finalized.
data
List of validator balances.
