Validator balances by state ID

The /eth/v1/beacon/states/{state_id}/validator_balances endpoint provides the balances of validators for a specified state in the Beacon Chain. This information is essential for tracking validators' financial stakes and rewards for participating in the Ethereum PoS mechanism.

👍

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

• state_id — the identifier for the state whose validator balances are being requested. The state_id can be one of the following:
  • head — represents the current head of the chain from the node's perspective.
  • genesis — refers to the genesis or initial state of the Beacon Chain.
  • finalized — the latest state that has been finalized and accepted by the network.
  • justified — a recently justified state, indicating preliminary consensus before finalization.
  • <slot> — a specific slot in the Ethereum protocol timeline.
  • <hex encoded stateRoot with 0x prefix> — a specific state root encoded in hexadecimal.

Response

The response includes an object with the following fields:

• data — an array of objects representing a validator's balance in the specified state. Each object contains:
  • index — the index number of the validator.
  • balance — the current balance of the validator in Gwei.