---
title: "PostBeaconStatesValidatorBalancesByStateId"
method: POST
path: "/{apiKey}/eth/v1/beacon/states/{stateId}/validator_balances"
---

# PostBeaconStatesValidatorBalancesByStateId

`POST /{apiKey}/eth/v1/beacon/states/{stateId}/validator_balances`

Get validator balances from state.

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 is returned for each balance, and can be used to confirm for which inputs a
response has been returned.

## Path parameters

- `apiKey` string, required — <style> .custom-style { color: #048FF4; } </style> For higher throughput, please <span class="custom-style"><a href="../docs/quick-start-guide#-creating-your-api-key-on-the-zan-platform" target="_blank">create your own API key</a></span>.
- `stateId` string, required

## Request body

- string[]

## Response `200`

The validator balances

- object
  - `execution_optimistic` boolean, required — 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.
  - `finalized` boolean, required — True if the response references the finalized history of the chain, as determined by fork choice. If the field is not present, additional calls are necessary to compare the epoch of the requested information with the finalized checkpoint.
  - `data` object[], required
    - `index` string, required — Index of validator in validator registry.
    - `balance` string, required — Current validator balance in gwei.

---

[API](https://skmtc.net/zan/apis/zan-getnftmetadata.md) · [All operations](https://skmtc.net/zan/apis/zan-getnftmetadata/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zan/zan-getnftmetadata/versions/be8fa2338895/schema)