Epoch overview

curl --request GET \
  --url 'https://beaconcha.in/api/v1/epoch/{epoch}?apikey='

{
  "status": "OK",
  "data": {
    "epoch": 15000,
    "ts": "2022-09-29T04:00:23Z",
    "finalized": true,
    "validatorscount": 436943,
    "averagevalidatorbalance": 33827474537,
    "totalvalidatorbalance": 14780678206789428,
    "globalparticipationrate": 0.9885170459747314,
    "eligibleether": 13982056000000000,
    "votedether": 13821500000000000,
    "blockscount": 32,
    "proposedblocks": 31,
    "missedblocks": 1,
    "orphanedblocks": 0,
    "scheduledblocks": 0,
    "attestationscount": 3458,
    "attesterslashingscount": 0,
    "proposerslashingscount": 1,
    "depositscount": 12,
    "withdrawalcount": 16,
    "voluntaryexitscount": 2,
    "rewards_exported": true
  }
}

GET

api

epoch

{epoch}

Epoch overview

curl --request GET \
  --url 'https://beaconcha.in/api/v1/epoch/{epoch}?apikey='

{
  "status": "OK",
  "data": {
    "epoch": 15000,
    "ts": "2022-09-29T04:00:23Z",
    "finalized": true,
    "validatorscount": 436943,
    "averagevalidatorbalance": 33827474537,
    "totalvalidatorbalance": 14780678206789428,
    "globalparticipationrate": 0.9885170459747314,
    "eligibleether": 13982056000000000,
    "votedether": 13821500000000000,
    "blockscount": 32,
    "proposedblocks": 31,
    "missedblocks": 1,
    "orphanedblocks": 0,
    "scheduledblocks": 0,
    "attestationscount": 3458,
    "attesterslashingscount": 0,
    "proposerslashingscount": 1,
    "depositscount": 12,
    "withdrawalcount": 16,
    "voluntaryexitscount": 2,
    "rewards_exported": true
  }
}

Authorizations

apikey

string

query

required

Path Parameters

epoch

required

The epoch to fetch. Provide an integer epoch number (>= 0), or one of the keywords latest or finalized. Special tags for convenience.

Available options:

latest,

finalized

Example:

"latest"

Response

The epoch was found and aggregate information is returned in the data field.

Standard success envelope used by all API endpoints.

status

enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:

OK

data

object

Aggregate metrics, counts, and status for a single beacon chain epoch.

Show child attributes

data.epoch

integer

Epoch number you requested. An epoch groups a fixed number of consecutive slots (see chain config).

Example:

15000

data.ts

string<date-time>

The UTC timestamp at which this epoch started, in RFC 3339 format.

Example:

"2022-09-29T04:00:23Z"

data.finalized

boolean

Indicates whether this epoch has been finalized by the consensus protocol. Finalized epochs will not be reverted under normal network operation.

Example:

true

data.validatorscount

integer

Total number of active validators in this epoch.

Example:

436943

data.averagevalidatorbalance

integer

Average validator balance during this epoch, in gwei.

Example:

33827474537

data.totalvalidatorbalance

integer

Sum of balances of all active validators during this epoch, in gwei.

Example:

14780678206789428

data.globalparticipationrate

number<float>

Share of eligible stake that attested on time in this epoch, as a fraction between 0 and 1.

Example:

0.9885170459747314

data.eligibleether

integer

Total effective stake eligible to vote in this epoch, in gwei.

Example:

13982056000000000

data.votedether

integer

Total amount of stake that actually voted in this epoch, in gwei.

Example:

13821500000000000

data.blockscount

integer

Total number of slots in the epoch that contained a block (proposed, including orphaned).

Example:

32

data.proposedblocks

integer

Number of blocks proposed and included in the canonical chain during this epoch.

Example:

31

data.missedblocks

integer

Number of scheduled proposals that were missed (no block proposed) in this epoch.

Example:

1

data.orphanedblocks

integer

Number of blocks proposed but not part of the canonical chain (reorged/orphaned) in this epoch.

Example:

0

data.scheduledblocks

integer

Number of scheduled block proposals in this epoch. Typically equals the number of slots in an epoch.

Example:

0

data.attestationscount

integer

Number of attestation operations included across all blocks in this epoch.

Example:

3458

data.attesterslashingscount

integer

Number of attester slashing operations included in this epoch.

Example:

0

data.proposerslashingscount

integer

Number of proposer slashing operations included in this epoch.

Example:

1

data.depositscount

integer

Number of validator deposit operations processed in this epoch.

Example:

12

data.withdrawalcount

integer

Number of withdrawal operations processed in this epoch.

Example:

16

data.voluntaryexitscount

integer

Number of voluntary exit operations processed in this epoch.

Example:

2

data.rewards_exported

boolean

Indicates whether per-validator reward details for this epoch have been exported and are available for querying.

Example:

true

Latest consensus and execution state

Epoch slots

Introduction

API Docs

Epoch overview

Authorizations

Path Parameters

Response