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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/staking/consensus-health.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.