/eth/v1/beacon/states/{state_id}/validator_balances RPC Method

Parameters

state_id

string

REQUIRED

The state identifier. It can be one of: head (canonical head in node's view), genesis, finalized, justified, slot and stateRoot (hex encoded stateRoot with 0x prefix)

id

array

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

Returns

execution_optimistic

boolean

It's true if the response references an unverified execution payload. The optimistic information may be invalidated at a later time. If the field is not present, assume the false value

data

The object with the following values:

index

string

The index of validator in validator registry

balance

string

The current validator balance in gwei

Request

curl -X GET \
    "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0xb8309891538bca2c1cb416a0a60378185ea705f665b8cf7e60b4b22380145bc611fb711062a835bf599b86d04e0d449a" \
    -H "accept: application/json"

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0xb8309891538bca2c1cb416a0a60378185ea705f665b8cf7e60b4b22380145bc611fb711062a835bf599b86d04e0d449a", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests

url = "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0xb8309891538bca2c1cb416a0a60378185ea705f665b8cf7e60b4b22380145bc611fb711062a835bf599b86d04e0d449a"

payload={}
headers = {
  'accept': 'application/json'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0xb8309891538bca2c1cb416a0a60378185ea705f665b8cf7e60b4b22380145bc611fb711062a835bf599b86d04e0d449a")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = "application/json"

response = https.request(request)
puts response.read_body

Response

{
  "execution_optimistic": false,
  "finalized": false,
  "data": [
    {
      "index": "91343",
      "balance": "0"
    }
  ]
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free