GET
/
beacon
/
states
/
{state_id}
/
validator_balances
Get validator balances by state and ID
curl --request GET \
  --url https://beacon-nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7/eth/v1/beacon/states/{state_id}/validator_balances
{
  "data": [
    {
      "index": "<string>",
      "balance": "<string>"
    }
  ]
}
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 todayStart 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.

Path Parameters

​
state_id
string
default:head
required

State identifier, e.g., 'head', 'finalized', 'genesis', or a specific slot number.

Query Parameters

​
id
string
default:1
required

Validator ID

Response

200
application/json

Validator balances successfully retrieved

The response is of type object.