ETH2 REST API
The latest and up-to-date ETH2 REST API.

OpenAPI definition

ConsenSys manages the up-to-date TEKU REST API documentation below which contains full details on the ETH2 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}