Updated on 2023-12-06 GMT+08:00

Beacon Node APIs

Table 1 Beacon node APIs

API Method

Type

Description

Throughput (Time/s)

4 vCPUs | 16 GB

8 vCPUs | 32 GB

16 vCPUs | 32 GB

/eth/v1/beacon/genesis

GET

Get details of the chain's genesis.

5000

10000

23000

/eth/v1/beacon/states/{state_id}/root

GET

Get the HashTreeRoot for a given state_id.

3000

6000

13000

/eth/v1/beacon/states/{state_id}/fork

GET

Get the fork object for a given state_id.

3000

7000

17000

/eth/v1/beacon/states/{state_id}/finality_checkpoints

GET

Get finality checkpoints for a state.

3000

7000

17000

/eth/v1/beacon/states/{state_id}/validators

GET

Get the validator information.

5

5

5

/eth/v1/beacon/states/{state_id}/validators/{validator_id}

GET

Get the information for a given validator_id.

300

600

1000

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

GET

Get the validator balance.

5

5

5

/eth/v1/beacon/states/{state_id}/committees

GET

Get the committees for a state.

5

6

15

/eth/v1/beacon/states/{state_id}/sync_committees

GET

Get sync committees for a state.

1100

2800

5000

/eth/v1/beacon/headers

GET

Get block headers matching given query.

1800

4000

8000

/eth/v1/beacon/headers/{block_id}

GET

Get the block header for a given block ID.

1400

2000

6000

/eth/v2/beacon/blocks/{block_id}

GET

Get the block information for the given block ID.

50

90

300

/eth/v1/beacon/blocks/{block_id}/root

GET

Get the block root information for a given block ID.

5000

9000

22000

/eth/v1/beacon/blocks/{block_id}/attestations

GET

Get the attestation included in for given block ID.

300

700

1800

/eth/v1/beacon/rewards/blocks/{block_id}

GET

Get the block reward information.

90

110

120

/eth/v1/beacon/rewards/attestations/{epoch}

POST

Get the validator rewards of the corresponding epoch.

5

5

5

/eth/v1/beacon/blinded_blocks/{block_id}

GET

Get the blinded block for given block ID.

300

600

1400

/eth/v1/beacon/pool/attestations

GET

Get attestations from the operations pool.

2200

3000

4000

/eth/v1/beacon/pool/attester_slashings

GET

Get attester slashings from the operations pool.

5000

10000

23000

/eth/v1/beacon/pool/proposer_slashings

GET

Get proposer slashings from the operations pool.

6000

11000

24000

/eth/v1/beacon/pool/voluntary_exits

GET

Get SignedVuntaryExit from the operations pool.

5000

11000

24000

/eth/v1/beacon/pool/bls_to_execution_changes

GET

Get BLS to execution changes known by the node but not necessarily incorporated into any block.

6000

11000

24000

/eth/v1/builder/states/{state_id}/expected_withdrawals

GET

Get the withdrawals that are to be included for the block built on the specified state.

2000

3000

6000

/eth/v1/config/fork_schedule

GET

Get all forks.

6000

10000

21000

/eth/v1/config/spec

GET

Get the specification configurations used on this node.

1700

4000

9000

/eth/v1/config/deposit_contract

GET

Get the Eth1 deposit contract address and chain ID.

7000

10000

24000

/eth/v2/debug/beacon/states/{state_id}

GET

Get the full BeaconState object.

5

5

5

/eth/v2/debug/beacon/heads (Deprecated)

GET

Get all chain headers.

6000

10000

13000

/eth/v1/debug/fork_choice

GET

Get the fork choice array.

600

1000

2000

/eth/v1/events

GET

Subscribe to beacon node events.

-

-

-

/eth/v1/node/version

GET

Get the beacon node version.

5000

10000

23000

/eth/v1/node/syncing

GET

Get the beacon node syncing status.

5000

10000

23000

/eth/v1/node/health

GET

Get the health check result of the beacon node.

5000

11000

24000

/eth/v1/validator/duties/attester/{epoch}

POST

Get validator duties.

5

5

5

/eth/v1/validator/duties/proposer/{epoch}

GET

Get block proposer duties.

5

5

5

/eth/v1/validator/duties/sync/{epoch}

POST

Get sync committee duties.

5

5

5

/eth/v1/validator/aggregate_attestation

GET

Get aggregated attestation.

4000

8000

15000

/eth/v1/validator/sync_committee_contribution

GET

Produce a sync committee contribution.

5000

11000

18000

/eth/v1/validator/liveness/{epoch}

POST

Return if a validator has been observed on the network.

5

5

5