---
title: "Get validator balances from state"
method: GET
path: "/eth/v1/beacon/states/{state_id}/validator_balances"
tags: ["Beacon"]
---

# Get validator balances from state

`GET /eth/v1/beacon/states/{state_id}/validator_balances`

## Request

- Base URL: `eth2-beacon-mainnet.nodereal.io/v1/api_key` (relative, and the document’s source URL is not known)
- URL: `eth2-beacon-mainnet.nodereal.io/v1/api_key/eth/v1/beacon/states/{state_id}/validator_balances`
- Auth: none declared

Returns filterable list of validators balances.

Balances will be returned for all indices or public key 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.  There are no guarantees for the
returned data in terms of ordering; the index and is returned for each balance, and can be used to confirm for which inputs a
response has been returned.

## Path parameters

- `state_id` string, required

## Query parameters

- `id` string[]

## Response `200`

Success

- object
  - `execution_optimistic` boolean: True if the response references an unverified execution payload. Optimistic information may be invalidated at a later time. If the field is not present, assume the False value.
  - `data` object[]
    - `index` string: Index of validator in validator registry.
    - `balance` string: Current validator balance in gwei.

## Other responses

- `400`: Invalid state or validator ID
- `500`: Beacon node internal error.

---

[API](https://skmtc.dev/nodereal/apis/eth-beacon-node-api.md) - [All operations](https://skmtc.dev/nodereal/apis/eth-beacon-node-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodereal/apis/eth-beacon-node-api/revisions/1878ea8657a1?raw)