Updated on 2024-11-14 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 | 64 GB

/eth/v1/beacon/genesis

GET

Get details of the chain's genesis.

5000/2500

10000/5000

23000/11500

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

GET

Get the HashTreeRoot for a given state_id.

3000/1500

6000/3000

13000/6500

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

GET

Get the fork object for a given state_id.

3000/1500

7000/3500

17000/8500

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

GET

Get finality checkpoints for a state.

3000/1500

7000/3500

17000/8500

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

GET

Get the validator information.

5/2

5/2

5/2

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

GET

Get the information for a given validator_id.

300/150

600/300

1000/500

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

GET

Get the validator balance.

5/2

5/2

5/2

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

GET

Get the committees for a state.

5/2

6/3

15/7

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

GET

Get sync committees for a state.

1100/550

2800/1400

5000/2500

/eth/v1/beacon/headers

GET

Get block headers matching given query.

1800/900

4000/2000

8000/4000

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

GET

Get the block header for a given block ID.

1400/700

2000/1000

6000/3000

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

GET

Get the block information for the given block ID.

50/25

90/45

300/150

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

GET

Get the block root information for a given block ID.

5000/2500

9000/4500

22000/11000

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

GET

Get the attestation included in for given block ID.

300/150

700/350

1800/900

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

GET

Get the block reward information.

90/45

110/55

120/60

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

POST

Get the validator rewards of the corresponding epoch.

5/2

5/2

5/2

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

GET

Get the blinded block for given block ID.

300/150

600/300

1400/700

/eth/v1/beacon/pool/attestations

GET

Get attestations from the operations pool.

2200/1100

3000/1500

4000/2000

/eth/v1/beacon/pool/attester_slashings

GET

Get attester slashings from the operations pool.

5000/2500

10000/5000

23000/11500

/eth/v1/beacon/pool/proposer_slashings

GET

Get proposer slashings from the operations pool.

6000/3000

11000/5500

24000/12000

/eth/v1/beacon/pool/voluntary_exits

GET

Get SignedVuntaryExit from the operations pool.

5000/2500

11000/5500

24000/12000

/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/3000

11000/5500

24000/12000

/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/1000

3000/1500

6000/3000

/eth/v1/config/fork_schedule

GET

Get all forks.

6000/3000

10000/5000

21000/10500

/eth/v1/config/spec

GET

Get the specification configurations used on this node.

1700/850

4000/2000

9000/4500

/eth/v1/config/deposit_contract

GET

Get the Eth1 deposit contract address and chain ID.

7000/3500

10000/5000

24000/12000

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

GET

Get the full BeaconState object.

5/2

5/2

5/2

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

GET

Get all chain headers.

6000/3000

10000/5000

13000/6500

/eth/v1/debug/fork_choice

GET

Get the fork choice array.

600/300

1000/500

2000/1000

/eth/v1/events

GET

Subscribe to beacon node events.

-

-

-

/eth/v1/node/version

GET

Get the beacon node version.

5000/2500

10000/5000

23000/11500

/eth/v1/node/syncing

GET

Get the beacon node syncing status.

5000/2500

10000/5000

23000/11500

/eth/v1/node/health

GET

Get the health check result of the beacon node.

5000/2500

11000/5500

24000/12000

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

POST

Get validator duties.

5/2

5/2

5/2

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

GET

Get block proposer duties.

5/2

5/2

5/2

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

POST

Get sync committee duties.

5/2

5/2

5/2

/eth/v1/validator/aggregate_attestation

GET

Get aggregated attestation.

4000/2000

8000/4000

15000/7500

/eth/v1/validator/sync_committee_contribution

GET

Produce a sync committee contribution.

5000/2500

11000/5500

18000/9000

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

POST

Return if a validator has been observed on the network.

5/2

5/2

5/2