# Consensus Health

## Contents

* [Attestation Count](#attestcnt)
* [Attestations in Epoch](#attestepochcnt)
* [Count of Validators with Attestation in Epoch](#attestepochvalcnt)
* [Count of Validators with Attestation](#attestvalcnt)
* [Count of Validators with Late Attestation](#attestvallatecnt)
* [Current Epoch](#epochcurr)
* [Latest Finalized Epoch](#epochfinal)
* [Latest Justified Epoch](#epochjust)
* [Participation Rate](#epochjust-1)

## Attestation Count <a href="#attestcnt" id="attestcnt"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/AttestCnt>" %}

## Attestations in Epoch <a href="#attestepochcnt" id="attestepochcnt"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/AttestEpochCnt>" %}

## Count of Validators with Attestation in Epoch <a href="#attestepochvalcnt" id="attestepochvalcnt"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/AttestEpochValCnt>" %}

## Count of Validators with Attestation <a href="#attestvalcnt" id="attestvalcnt"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/AttestValCnt>" %}

## Count of Validators with Late Attestation <a href="#attestvallatecnt" id="attestvallatecnt"></a>

### Definition

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

<table><thead><tr><th>Name</th><th width="164">MetricID</th><th>Unit</th><th>Interval</th></tr></thead><tbody><tr><td>Count of Validators with Late Attestation</td><td>AttestValLateCnt</td><td>Validators</td><td>1 minute</td></tr></tbody></table>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/AttestValLateCnt>" %}

## Current Epoch <a href="#epochcurr" id="epochcurr"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/EpochCurr>" %}

## Latest Finalized Epoch <a href="#epochfinal" id="epochfinal"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/EpochFinal>" %}

## Latest Justified Epoch <a href="#epochjust" id="epochjust"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/EpochJust>" %}

## Participation Rate <a href="#epochjust" id="epochjust"></a>

### 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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/StkPartRateMean>" %}

## 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.

{% openapi src="<https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-1522f16027d90845f8750dd9c51c03b8e7aab67f%2Fopenapi.yaml?alt=media>" path="/timeseries/asset-metrics" method="get" %}
[openapi.yaml](https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-1522f16027d90845f8750dd9c51c03b8e7aab67f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% tabs %}
{% tab title="Shell" %}

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

{% endtab %}

{% tab title="Python" %}

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

{% endtab %}

{% tab title="Python Client" %}

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

{% endtab %}
{% endtabs %}