Consensus Health

Contents

• Attestation Count

• Attestations in Epoch

• Count of Validators with Attestation in Epoch

• Count of Validators with Attestation

• Count of Validators with Late Attestation

• Current Epoch

• Latest Finalized Epoch

• Latest Justified Epoch

• Participation Rate

Attestation Count

Definition

Count of Attestations in a 1 minute interval. One attestation can aggregate multiple validators votes.

Name	MetricID	Unit	Interval
Attestation Count	AttestCnt	Attestations	1 minute

Details

• Count of all attestations in the last 1 minute interval.

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/AttestCntcoverage.coinmetrics.io

Attestations in Epoch

Definition

Count of Attestations in a 1 minute interval within the current Epoch. One attestation can aggregate multiple validators votes.

Name	MetricID	Unit	Interval
Attestations in Epoch Count	AttestEpochCnt	Attestations	1 minute

Details

• Count of all attestations in the last 1 minute interval in the current Epoch.

• If the current 1 minute window spans an Epoch boundary only attestations in the current Epoch are counted.

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/AttestEpochCntcoverage.coinmetrics.io

Count of Validators with Attestation in Epoch

Definition

Count of Validators who attested in a 1 minute interval within the current Epoch.

Name	MetricID	Unit	Interval
Count of Validators with Attestation in Epoch	AttestEpochValCnt	Validators	1 minute

Details

• Count of all validators who attested in the last 1 minute interval in the current Epoch.

• If the current 1 minute window spans an Epoch boundary only validators attesting in the current Epoch are counted.

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/AttestEpochValCntcoverage.coinmetrics.io

Count of Validators with Attestation

Definition

Count of Validators who attested in a 1 minute interval.

Name	MetricID	Unit	Interval
Count of Validators with Attestation	AttestValCnt	Validators	1 minute

Details

• Count of all validators who attested in the last 1 minute interval.

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/AttestValCntcoverage.coinmetrics.io

Count of Validators with Late Attestation

Definition

Count of Validators who attested late in a 1 minute interval.

Name	MetricID	Unit	Interval
Count of Validators with Late Attestation	AttestValLateCnt	Validators	1 minute

Details

• Count of all validators who attested late in the last 1 minute interval.

• A late attestation is one whose slot is not the previous slot

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/AttestValLateCntcoverage.coinmetrics.io

Current Epoch

Definition

Number of the current Epoch

Name	MetricID	Unit	Interval
Current Epoch	EpochCurr	Epoch	1 minute

Details

• Returns the number of the current Epoch, updated on a 1 minute interval

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/EpochCurrcoverage.coinmetrics.io

Latest Finalized Epoch

Definition

Number of the latest finalized Epoch

Name	MetricID	Unit	Interval
Latest Finalized Epoch	EpochFinal	Epoch	1 minute

Details

• Returns the number of the latest Finalized Epoch, updated on a 1 minute interval.

• Finalization rules follow those of the underlying protocol.

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/EpochFinalcoverage.coinmetrics.io

Latest Justified Epoch

Definition

Number of the latest justified Epoch

Name	MetricID	Unit	Interval
Latest Justified Epoch	EpochJust	Epoch	1 minute

Details

• Returns the number of the latest Justified Epoch, updated on a 1 minute interval.

• Rules for considering an Epoch Justified follow those of the underlying protocol.

Release History

• Released November 2023.

Availability for Assets

https://coverage.coinmetrics.io/asset-metrics/EpochJustcoverage.coinmetrics.io

Participation Rate

Definition

Rate of Validators participating in each Epoch

Name	MetricID	Unit	Interval
Participation Rate	StkPartRateMean	Dimensionless	1 day

Details

• Returns the percent of validation stake that participated in the time interval out of the total eligible validation stake that could have participated

• Calculated for each epoch in the time period and aggregated across the time period.

• Formula for each Epoch: target attesting gwei / active gwei

Release History

• Released May 2024.

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

Consensus Health metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's above (Attest*, Epoch* , etc) in the metrics parameter.

Asset metrics

Returns requested metrics for specified assets. Results for block by block metrics (1b frequency) are ordered by tuple (asset, height, block_hash), all other metrics are ordered by tuple (asset, time). You can change the sorting using sort query parameter. Supported output formats are json (default) and csv, use format query parameter to override it. To fetch the next page of results use next_page_url JSON response field or x-next-page-url CSV HTTP header if present. If multiple metrics are requested in the same time the strict policy for partially available metrics among requested ones is applied:

GEThttps://api.coinmetrics.io/v4/timeseries/asset-metrics

Authorization

api_key

Query parameters

Response

200400401403414

Time series of metrics for an asset.

Body

application/jsontext/csv

data*any

next_page_tokenNextPageToken (string)

Token of the next page results for a given request.

next_page_urlNextPageUrl (string)

URL of the next page results for a given request.

Response

200400401403

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=AttestCnt&assets=eth&pretty=true&api_key=<your_key>"

Python

import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=AttestCnt&assets=eth&pretty=true&api_key=<your_key>').json()
print(response)

Python Client

from coinmetrics.api_client import CoinMetricsClient

api_key = "<API_KEY>"
client = CoinMetricsClient(api_key)

print(
    client.get_asset_metrics(
        metrics="AttestCnt", 
        assets="eth",
    ).to_dataframe()
)