Beacon Chain REST API
The latest and up-to-date ETH2 REST API.
Infura is deprecating the Beacon Chain network on approximately 12 October 2022.

OpenAPI definition

ConsenSys manages the up-to-date TEKU REST API documentation below which contains full details on the beacon chain method calls.
ConsenSys Teku REST API documentation
Current stable version Teku (v22.4.0)
Ignore the TEKU section of methods.

Infura supported methods

The API is in constant development and not all methods are currently supported by Infura.
Check the list below for the current Infura-supported methods.

Config

  • /eth/v1/config/spec: {GET}
  • /eth/v1/config/fork_schedule: {GET}
  • /eth/v1/config/deposit_contract: {GET}

Beacon

  • /eth/v1/beacon/genesis: {GET}
  • /eth/v1/beacon/headers: {GET}
  • /eth/v1/beacon/blocks: {POST}
  • /eth/v1/beacon/blocks/:block_id: {GET} // DEPRECATED IN TEKU 21.8.0
  • /eth/v2/beacon/blocks/:block_id: {GET}
  • /eth/v1/beacon/blocks/:block_id/attestations: {GET}
  • /eth/v1/beacon/blocks/:block_id/root: {GET}
  • /eth/v1/beacon/pool/attestations: {POST}
  • /eth/v1/beacon/pool/voluntary_exits: {POST}
  • /eth/v1/beacon/pool/proposer_slashings: {POST}
  • /eth/v1/beacon/pool/attester_slashings: {POST}
  • /eth/v1/beacon/pool/sync_committees: {POST}
  • /eth/v1/beacon/headers/:block_id: {GET}
  • /eth/v1/beacon/states/:state_id/root: {GET}
  • /eth/v1/beacon/states/:state_id/fork: {GET}
  • /eth/v1/beacon/states/:state_id/committees: {GET}
  • /eth/v1/beacon/states/:state_id/committees/:epoch: {GET}
  • /eth/v1/beacon/states/:state_id/finality_checkpoints: {GET}
  • /eth/v1/beacon/states/:state_id/validators: {GET}
  • /eth/v1/beacon/states/:state_id/validators/:validator_id: {GET}
  • /eth/v1/beacon/states/:state_id/validator_balances: {GET}
  • /eth/v1/beacon/states/:state_id/sync_committees: {GET}

Node

  • /eth/v1/node/health: {GET}
  • /eth/v1/node/syncing: {GET}
  • /eth/v1/node/version: {GET}

Validator

  • /eth/v1/validator/aggregate_attestation: {GET}
  • /eth/v1/validator/aggregate_and_proofs: {POST}
  • /eth/v1/validator/beacon_committee_subscriptions: {POST}
  • /eth/v1/validator/sync_committee_subscriptions: {POST}
  • /eth/v1/validator/attestation_data: {GET}
  • /eth/v1/validator/duties/attester/:epoch: {POST}
  • /eth/v1/validator/duties/proposer/:epoch: {GET}
  • /eth/v1/validator/duties/sync/:epoch: {POST}
  • /eth/v1/validator/blocks/:slot: {GET} // DEPRECATED IN TEKU 21.8.0
  • /eth/v2/validator/blocks/:slot: {GET}
  • /eth/v1/validator/sync_committee_contribution: {GET}
  • /eth/v1/validator/contribution_and_proofs: {POST}

Debug

  • /eth/v1/debug/beacon/heads: {GET}
  • /eth/v1/debug/beacon/states/:state_id: {GET} // DEPRECATED IN TEKU 21.8.0
  • /eth/v2/debug/beacon/states/:state_id: {GET}

Events

  • /eth/v1/events: {GET}
Copy link
On this page
OpenAPI definition
Infura supported methods