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

status

string

Validator status specification

Returns

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

array

The object with the following fields:

index

string

The index of validator in validator registry

balance

string

The current validator balance in gwei

status

String

The type of possible status values:

pending_initialized

When the first deposit is processed, but not enough funds are available (or not yet the end of the first epoch) to get validator into the activation queue

pending_queued

When validator is waiting to get activated, and have enough funds etc. while in the queue, validator activation epoch keeps changing until it gets to the front and make it through (finalization is a requirement here too)

active_ongoing

When validator must be attesting, and have not initiated any exit

active_exiting

When validator is still active, but filed a voluntary request to exit

active_slashed

When validator is still active, but have a slashed status and is scheduled to exit

exited_unslashed

When validator has reached reguler exit epoch, not being slashed, and doesn't have to attest any more, but cannot withdraw yet

exited_slashed

When validator has reached reguler exit epoch, but was slashed, have to wait for a longer withdrawal period

withdrawal_possible

After validator has exited, a while later is permitted to move funds, and is truly out of the system

withdrawal_done

(not possible in phase0, except slashing full balance) actually having moved funds away

validator

object

The object with the following fields:

pubkey

string

The validator's BLS public key, uniquely identifying them. _48-bytes, hex encoded with 0x prefix, case insensitive

withdrawal_crendetials

String

The root of withdrawal credentials

effective_balance

String

The balance at stake in Gwei

slashed

String

Was validator slashed (not longer active)

activation_elgibility_epoch

String

When criteria for activation were met

activation_epoch

String

Epoch when validator activated. FAR_FUTURE_EPOCH if not activated

exit_epoch

String

Epoch when validator exited

withdrawable_epoch

String

When validator can withdraw or transfer funds. FAR_FUTURE_EPOCH if not defined

Request

1
curl -X GET "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/validators?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/validators?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/validators?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/validators?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/validators?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/validators?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/validators?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/validators?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
  "data": [
4
    {
5
      "index": "42",
6
      "balance": "32756234517",
7
      "status": "active_ongoing",
8
      "validator": {
9
        "pubkey": "0x8a6aa2eb61ac6d62357b19969be8d4a4e034613aca7096c63667f5b590637af24692d148a4b82b855e1b74d9fc1be1c2",
10
        "withdrawal_credentials": "0x0100000000000000000000007e4aa755550152a5d0e121a40dc83c23ddb48764",
11
        "effective_balance": "32000000000",
12
        "slashed": false,
13
        "activation_eligibility_epoch": "16083",
14
        "activation_epoch": "16141",
15
        "exit_epoch": "18446744073709551615",
16
        "withdrawable_epoch": "18446744073709551615"
17
      }
18
    },
19
    {
20
      "index": "169",
21
      "balance": "32381554210",
22
      "status": "active_ongoing",
23
      "validator": {
24
        "pubkey": "0x934d0aaf9c72e92a06d83b905d39397327a74e0a5ee5305271118ee0e606b707c344d96fa7b15327bf565fbea90d1d9c",
25
        "withdrawal_credentials": "0x01000000000000000000000038cb9831ba67e053ba68d36060374b3ec7e5d9ae",
26
        "effective_balance": "32000000000",
27
        "slashed": false,
28
        "activation_eligibility_epoch": "16592",
29
        "activation_epoch": "16650",
30
        "exit_epoch": "18446744073709551615",
31
        "withdrawable_epoch": "18446744073709551615"
32
      }
33
    },
34
    {
35
      "index": "782",
36
      "balance": "32045678123",
37
      "status": "active_exiting",
38
      "validator": {
39
        "pubkey": "0xa5e94e8abcef2d9cbec0613449e89aa4172a348b28c913b43061f57920cd16c18b77428fd80374ff1d68d82af3347977",
40
        "withdrawal_credentials": "0x010000000000000000000000f5a5d9c2c3b1a0b5e6d8d7f9e2c1b0a9d8c7f6e5",
41
        "effective_balance": "32000000000",
42
        "slashed": false,
43
        "activation_eligibility_epoch": "17256",
44
        "activation_epoch": "17314",
45
        "exit_epoch": "17890",
46
        "withdrawable_epoch": "18154"
47
      }
48
    }
49
  ]
50
}

1
{
2
  "execution_optimistic": false,
3
  "data": [
4
    {
5
      "index": "42",
6
      "balance": "32756234517",
7
      "status": "active_ongoing",
8
      "validator": {
9
        "pubkey": "0x8a6aa2eb61ac6d62357b19969be8d4a4e034613aca7096c63667f5b590637af24692d148a4b82b855e1b74d9fc1be1c2",
10
        "withdrawal_credentials": "0x0100000000000000000000007e4aa755550152a5d0e121a40dc83c23ddb48764",
11
        "effective_balance": "32000000000",
12
        "slashed": false,
13
        "activation_eligibility_epoch": "16083",
14
        "activation_epoch": "16141",
15
        "exit_epoch": "18446744073709551615",
16
        "withdrawable_epoch": "18446744073709551615"
17
      }
18
    },
19
    {
20
      "index": "169",
21
      "balance": "32381554210",
22
      "status": "active_ongoing",
23
      "validator": {
24
        "pubkey": "0x934d0aaf9c72e92a06d83b905d39397327a74e0a5ee5305271118ee0e606b707c344d96fa7b15327bf565fbea90d1d9c",
25
        "withdrawal_credentials": "0x01000000000000000000000038cb9831ba67e053ba68d36060374b3ec7e5d9ae",
26
        "effective_balance": "32000000000",
27
        "slashed": false,
28
        "activation_eligibility_epoch": "16592",
29
        "activation_epoch": "16650",
30
        "exit_epoch": "18446744073709551615",
31
        "withdrawable_epoch": "18446744073709551615"
32
      }
33
    },
34
    {
35
      "index": "782",
36
      "balance": "32045678123",
37
      "status": "active_exiting",
38
      "validator": {
39
        "pubkey": "0xa5e94e8abcef2d9cbec0613449e89aa4172a348b28c913b43061f57920cd16c18b77428fd80374ff1d68d82af3347977",
40
        "withdrawal_credentials": "0x010000000000000000000000f5a5d9c2c3b1a0b5e6d8d7f9e2c1b0a9d8c7f6e5",
41
        "effective_balance": "32000000000",
42
        "slashed": false,
43
        "activation_eligibility_epoch": "17256",
44
        "activation_epoch": "17314",
45
        "exit_epoch": "17890",
46
        "withdrawable_epoch": "18154"
47
      }
48
    }
49
  ]
50
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free