Beacon

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

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

Path parameters

state_idstring required

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

idstring[]

Either hex encoded public key (any bytes48 with 0x prefix) or validator index

Response

Success

execution_optimisticboolean

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.

Example response

{
  "data": [
    {
      "index": "1",
      "balance": "1"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.