Beacon Node APIs

Updated on 2024-11-14 GMT+08:00

View PDF

**Table 1** Beacon node APIs
API Method	Type	Description	Throughput (Time/s)
API Method	Type	Description	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