SSZ Response Support

This endpoint also supports SSZ (SimpleSerialize) responses. Set Accept: application/octet-stream in the request header to receive an SSZ-encoded payload instead of JSON. SSZ responses are smaller and faster to parse, and are useful for consensus-layer clients and indexers. Note: full beacon state responses can be very large (hundreds of MB) — streaming the response directly to a file is recommended.

curl --location "YOUR_QUICKNODE_ETHEREUM_URL/eth/v2/debug/beacon/states/head" \
    --header "Accept: application/octet-stream" \
    --output state.ssz

Path Parameters

state_id

string

REQUIRED

Specifies the state ID to retrieve. Can be one of: head (canonical head in node's view), genesis, finalized, justified, <slot>, <hex encoded stateRoot with 0x prefix>

Returns

version

string

Version values such as phase0, altair, bellatrix, capella, and deneb

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

finalized

boolean

Indicates whether the state is finalized or not

data

object

The BeaconState object containing detailed state information at a specific point in the blockchain

genesis_time

string

The genesis time of the beacon chain

genesis_validators_root

string

The root hash of the genesis validators

slot

string

The current slot of the beacon chain

fork

object

Information about the current and previous fork versions and the epoch at which the current version was introduced

previous_version

string

The fork version before the current version

current_version

string

The current fork version

epoch

string

The epoch at which the current fork version was introduced

latest_block_header

object

The latest block header information

slot

string

The slot of the latest block

proposer_index

string

The index of the proposer of the latest block

parent_root

string

The root of the parent block

state_root

string

The root of the state at the time of this block

body_root

string

The root of the block body

block_roots

array

An array of block root hashes

state_roots

array

An array of state root hashes

historical_roots

array

An array of historical root hashes

eth1_data

object

An object of eth1 data

deposit_root

string

An deposit root

deposit_count

string

An deposit count value

block_hash

string

An block hash string

eth1_data_votes

array

An array of eth1 data votes

deposit_root

string

An deposit root

deposit_count

string

An deposit count value

block_hash

string

An block hash string

eth1_deposit_index

string

An string of the deposit index

validators

array

An array of objects containing validator info

pubkey

string

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

withdraw_credentials

string

Root of withdrawal credentials

effective_balance

string

Balance at stake in Gwei

slashed

boolean

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. 'FAR_FUTURE_EPOCH' if not exited

withdrawable_epoch

string

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

balances

array

Validator balances in gwei. Variable length list, maximum 1099511627776 items

randao_mixes

array

Fixed length of 65536 items

slashings

array

Per-epoch sums of slashed effective balances. Fixed length of 8192 items

previous_epoch_attestations

array

List of attestations from the previous epoch

aggregation_bits

string

Attester aggregation bits

data

object

Data object containing values from slot, index, beacon root, source and target

slot

string

Slot value

index

string

The index value

beacon_block_root

string

The beacon block root hash

source

string

The checkpoint source

epoch

string

The epoch of the justified checkpoint

root

string

The root of the justified checkpoint

target

string

The checkpoint target

epoch

string

The epoch of the justified checkpoint

root

string

The root of the justified checkpoint

inclusion_delay

string

Inclusion delay string value

proposer_index

string

Proposer index string value

current_epoch_attestations

array

List of attestations from the current epoch

justification_bits

string

Bitfield representing recent block justification

previous_justified_checkpoint

object

Information on the previously justified checkpoint

epoch

string

The epoch of the justified checkpoint

root

string

The root of the justified checkpoint

current_justified_checkpoint

object

Information on the currently justified checkpoint

epoch

string

The epoch of the justified checkpoint

root

string

The root of the justified checkpoint

finalized_checkpoint

object

Information on the finalized checkpoint

epoch

string

The epoch of the finalized checkpoint

root

string

The root of the finalized checkpoint

Request

1
curl -X GET "https://docs-demo.quiknode.pro/eth/v2/debug/beacon/states/head" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
curl -X GET "https://docs-demo.quiknode.pro/eth/v2/debug/beacon/states/head" \
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/v2/debug/beacon/states/head', {
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/v2/debug/beacon/states/head', {
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/v2/debug/beacon/states/head"
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/v2/debug/beacon/states/head"
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/v2/debug/beacon/states/head")
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/v2/debug/beacon/states/head")
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
  "version": "bellatrix",
3
  "execution_optimistic": false,
4
  "finalized": true,
5
  "data": {
6
    "genesis_time": "1606824023",
7
    "genesis_validators_root": "0x4b363db94e286120d76eb905340fdd4e54bfe9f06bf33ff6cf5ad27f511bfe95",
8
    "slot": "4903392",
9
    "fork": {
10
      "previous_version": "0x02000000",
11
      "current_version": "0x03000000",
12
      "epoch": "112260"
13
    },
14
    "latest_block_header": {
15
      "slot": "4903391",
16
      "proposer_index": "169",
17
      "parent_root": "0x7c52d736a5bc2a6bc90958cf04b7ac5bd0e3bba8c3a21586f84b92ecfac34025",
18
      "state_root": "0x3e3af6de006f32fb28a6f049bc4daa5cbe895b2badee473749c710e456c5cbe7",
19
      "body_root": "0x0e7ab76514893a35ce5d578188214f4c7354001002d45a18f60ab144b2932acb"
20
    },
21
    "validators": [
22
      {
23
        "pubkey": "0x8a6aa2eb61ac6d62357b19969be8d4a4e034613aca7096c63667f5b590637af24692d148a4b82b855e1b74d9fc1be1c2",
24
        "withdraw_credentials": "0x0100000000000000000000007e4aa755550152a5d0e121a40dc83c23ddb48764",
25
        "effective_balance": "32000000000",
26
        "slashed": false,
27
        "activation_elgibility_epoch": "16083",
28
        "activation_epoch": "16141",
29
        "exit_epoch": "18446744073709551615",
30
        "withdrawable_epoch": "18446744073709551615"
31
      }
32
    ],
33
    "balances": [
34
      "32756234517"
35
    ],
36
    "justification_bits": "0x0f",
37
    "previous_justified_checkpoint": {
38
      "epoch": "153230",
39
      "root": "0x3e3af6de006f32fb28a6f049bc4daa5cbe895b2badee473749c710e456c5cbe7"
40
    },
41
    "current_justified_checkpoint": {
42
      "epoch": "153231",
43
      "root": "0x0e7ab76514893a35ce5d578188214f4c7354001002d45a18f60ab144b2932acb"
44
    },
45
    "finalized_checkpoint": {
46
      "epoch": "153230",
47
      "root": "0x4e3af6de006f32fb28a6f049bc4daa5cbe895b2badee473749c710e456c5cbe7"
48
    }
49
  }
50
}

1
{
2
  "version": "bellatrix",
3
  "execution_optimistic": false,
4
  "finalized": true,
5
  "data": {
6
    "genesis_time": "1606824023",
7
    "genesis_validators_root": "0x4b363db94e286120d76eb905340fdd4e54bfe9f06bf33ff6cf5ad27f511bfe95",
8
    "slot": "4903392",
9
    "fork": {
10
      "previous_version": "0x02000000",
11
      "current_version": "0x03000000",
12
      "epoch": "112260"
13
    },
14
    "latest_block_header": {
15
      "slot": "4903391",
16
      "proposer_index": "169",
17
      "parent_root": "0x7c52d736a5bc2a6bc90958cf04b7ac5bd0e3bba8c3a21586f84b92ecfac34025",
18
      "state_root": "0x3e3af6de006f32fb28a6f049bc4daa5cbe895b2badee473749c710e456c5cbe7",
19
      "body_root": "0x0e7ab76514893a35ce5d578188214f4c7354001002d45a18f60ab144b2932acb"
20
    },
21
    "validators": [
22
      {
23
        "pubkey": "0x8a6aa2eb61ac6d62357b19969be8d4a4e034613aca7096c63667f5b590637af24692d148a4b82b855e1b74d9fc1be1c2",
24
        "withdraw_credentials": "0x0100000000000000000000007e4aa755550152a5d0e121a40dc83c23ddb48764",
25
        "effective_balance": "32000000000",
26
        "slashed": false,
27
        "activation_elgibility_epoch": "16083",
28
        "activation_epoch": "16141",
29
        "exit_epoch": "18446744073709551615",
30
        "withdrawable_epoch": "18446744073709551615"
31
      }
32
    ],
33
    "balances": [
34
      "32756234517"
35
    ],
36
    "justification_bits": "0x0f",
37
    "previous_justified_checkpoint": {
38
      "epoch": "153230",
39
      "root": "0x3e3af6de006f32fb28a6f049bc4daa5cbe895b2badee473749c710e456c5cbe7"
40
    },
41
    "current_justified_checkpoint": {
42
      "epoch": "153231",
43
      "root": "0x0e7ab76514893a35ce5d578188214f4c7354001002d45a18f60ab144b2932acb"
44
    },
45
    "finalized_checkpoint": {
46
      "epoch": "153230",
47
      "root": "0x4e3af6de006f32fb28a6f049bc4daa5cbe895b2badee473749c710e456c5cbe7"
48
    }
49
  }
50
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free