Path 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)

Query Parameters

id

string

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

array

The object with the following values:

index

string

The index of validator in validator registry

balance

string

The current validator balance in gwei

Request

1
curl -X GET "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
curl -X GET "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
async function main() {
2
    const response = await fetch('https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validator_balances?id=0', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

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

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
import requests
2
import json
3

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

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

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

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

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

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

Response

1
{
2
  "execution_optimistic": false,
3
  "finalized": false,
4
  "data": [
5
    {
6
      "index": "91343",
7
      "balance": "0"
8
    }
9
  ]
10
}

1
{
2
  "execution_optimistic": false,
3
  "finalized": false,
4
  "data": [
5
    {
6
      "index": "91343",
7
      "balance": "0"
8
    }
9
  ]
10
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free