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.

Details

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

Release History

• Released November 2023.

Availability for Assets

Attestations in Epoch

Definition

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

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

Count of Validators with Attestation in Epoch

Definition

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

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

Count of Validators with Attestation

Definition

Count of Validators who attested in a 1 minute interval.

Details

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

Release History

• Released November 2023.

Availability for Assets

Count of Validators with Late Attestation

Definition

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

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

Current Epoch

Definition

Number of the current Epoch

Details

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

Release History

• Released November 2023.

Availability for Assets

Latest Finalized Epoch

Definition

Number of the latest finalized Epoch

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

Latest Justified Epoch

Definition

Number of the latest justified Epoch

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

Participation Rate

Definition

Rate of Validators participating in each Epoch

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

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.

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

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)

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()
)