# Stakers

## Contents

* [Count of Senders to CL Contract](#sendercntclcont)
* [Total Unique Senders to CL Contract](#validatoractextcnt)
* [Active Exiting Validators](#validatoractextcnt)
* [Active Validators](#validatoractongcnt)
* [Slashed Validators](#validatoractslhcnt)
* [Stakers Count](#validatorcnt)
* [Daily Added Stakers](#validatoraddcnt1d)
* [Daily Removed Stakers](#validatorremcnt1d)
* [Inactive Ineligible Validators](#validatorextslhcnt)
* [Inactive Eligible Validators](#validatorextunslhcnt)
* [Validators Pending Eligibility](#validatorpndinitcnt)
* [Validator in Activation Queue](#validatorpndqedcnt)
* [Full Participation Issuance](#validatorpndqedcnt-1)

## Count of Senders to CL Contract <a href="#sendercntclcont" id="sendercntclcont"></a>

### Definition

Count of new addresses that have sent to the Consensus Layer (CL) contract.

| Name                            | MetricID        | Unit       | Interval |
| ------------------------------- | --------------- | ---------- | -------- |
| Count of Senders to CL Contract | SenderCntCLCont | Validators | 1 day    |

### Details

* Unique count of new addresses that have sent to the Consensus Layer (CL) smart contract (0x00000000219ab540356cBB839Cbe05303d7705Fa) over the daily interval, sourced from Coin Metrics ATLAS™ blockchain search engine.

### Release History

* Released September 2022.

### Availability for Assets

* N/A
*

## Total Unique Senders to CL Contract <a href="#sendertotclcont" id="sendertotclcont"></a>

### Definition

Unique count of all senders to the Consensus Layer (CL) contract.

<table><thead><tr><th>Name</th><th width="164">MetricID</th><th>Unit</th><th>Interval</th></tr></thead><tbody><tr><td>Total Unique Senders to CL Contract</td><td>SenderTotCLCont</td><td>Validators</td><td>1 day</td></tr></tbody></table>

### Details

* Unique count of all senders to the Consensus Layer (CL) smart contract (0x00000000219ab540356cBB839Cbe05303d7705Fa) over the daily interval, sourced from Coin Metrics ATLAS™ blockchain search engine.

### Release History

* Released September 2022.

### Availability for Assets

* N/A

## Active Exiting Validators <a href="#validatoractextcnt" id="validatoractextcnt"></a>

### Definition

Validators who have filed a voluntary request to exit.

| Name                      | MetricID           | Unit       | Interval      |
| ------------------------- | ------------------ | ---------- | ------------- |
| Active Exiting Validators | ValidatorActExtCnt | Validators | 1 day, 1 hour |

### Details

* Count of active ETH Consensus Layer (CL) validators that have filed a voluntary request to exit.

### Release History

* Released September 2022.

### Availability for Assets

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

## Active Validators <a href="#validatoractongcnt" id="validatoractongcnt"></a>

### Definition

Validators that are actively participating.

| Name              | MetricID           | Unit       | Interval      |
| ----------------- | ------------------ | ---------- | ------------- |
| Active Validators | ValidatorActOngCnt | Validators | 1 day, 1 hour |

### Details

* Count of ETH Consensus Layer (CL) validators that have completed the activation queue.

### Release History

* Released September 2022.

### Availability for Assets

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

## Slashed Validators <a href="#validatoractslhcnt" id="validatoractslhcnt"></a>

### Definition

Slashed validators scheduled to exit.

| Name               | MetricID           | Unit       | Interval      |
| ------------------ | ------------------ | ---------- | ------------- |
| Slashed Validators | ValidatorActSlhCnt | Validators | 1 day, 1 hour |

### Details

* Count of ETH Consensus Layer (CL) validators that have been slashed and are scheduled to exit.

### Release History

* Released September 2022.

### Availability for Assets

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

## Stakers Count <a href="#validatorcnt" id="validatorcnt"></a>

### Definition

Count of all validators.

| Name            | MetricID     | Unit       | Interval      |
| --------------- | ------------ | ---------- | ------------- |
| Validator Count | ValidatorCnt | Validators | 1 day, 1 hour |
| Delegator Count | DelegatorCnt | Delegators | 1 day         |
| Staker Count    | StakerCnt    | Stakers    | 1 day         |

### Details

* Number of validators on the Ethereum Consensus Layer (CL).
* Delegator count available for networks that support delegated PoS (e.g.: Solana)
* A validator who has directly staked native assets to participate in network consensus. A delegator has delegated their native asset to a validator in order to participate in network consensus.
* A staker is an account that has staked native assets to participate in network consensus. Stakers include both Delegators as well as Validators.

### Release History

* Released September 2022.

### Availability for Assets

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

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

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

## Daily Added Stakers <a href="#validatoraddcnt1d" id="validatoraddcnt1d"></a>

### Definition

Count of validators added daily.

| Name                   | MetricID          | Unit       | Interval      |
| ---------------------- | ----------------- | ---------- | ------------- |
| Daily Added Validators | ValidatorAddCnt1d | Validators | 1 day, 1 hour |
| Daily Added Delegators | DelegatorAddCnt1d | Delegators | 1 day         |
| Daily Added Stakers    | StakerAddCnt1d    | Stakers    | 1 day         |

### Details

* Number of validators added to the Ethereum Consensus Layer (CL) on a daily interval.
* Delegator metrics available for networks that support delegated PoS (e.g.: Solana)
* A validator who has directly staked native assets to participate in network consensus. A delegator has delegated their native asset to a validator in order to participate in network consensus.
* A staker is an account that has staked native assets to participate in network consensus. Stakers include both Delegators as well as Validators.

### Release History

* Released September 2022.

### Availability for Assets

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

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

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

## Daily Removed Stakers <a href="#validatorremcnt1d" id="validatorremcnt1d"></a>

### Definition

Count of validators removed daily.

| Name                     | MetricID          | Unit       | Interval      |
| ------------------------ | ----------------- | ---------- | ------------- |
| Daily Removed Validators | ValidatorRemCnt1d | Validators | 1 day, 1 hour |
| Daily Removed Delegators | DelegatorRemCnt1d | Delegators | 1 day         |
| Daily Removed Stakers    | StakerRemCnt1d    | Stakers    | 1 day         |

### Details

* For Ethereum:
  * Number of validators removed from the Ethereum Consensus Layer (CL) on a daily interval.
  * This figure will remain low until withdrawals are enabled, capturing mostly slashing.
  * Captures number of validators with 'exited' status and 'exited slashed' status.
* Delegator metrics available for networks that support delegated PoS (e.g.: Solana)
* A validator who has directly staked native assets to participate in network consensus. A delegator has delegated their native asset to a validator in order to participate in network consensus.
* A staker is an account that has staked native assets to participate in network consensus. Stakers include both Delegators as well as Validators.

### Release History

* Released September 2022.

### Availability for Assets

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

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

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

## Inactive Ineligible Validators <a href="#validatorextslhcnt" id="validatorextslhcnt"></a>

### Definition

Validators that have been slashed and are no longer active.

| Name                           | MetricID           | Unit       | Interval      |
| ------------------------------ | ------------------ | ---------- | ------------- |
| Inactive Ineligible Validators | ValidatorExtSlhCnt | Validators | 1 day, 1 hour |

### Details

* Count of ETH Consensus Layer (CL) validators that have been slashed and are no longer active.

### Release History

* Released September 2022.

### Availability for Assets

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

## Inactive Eligible Validators <a href="#validatorextunslhcnt" id="validatorextunslhcnt"></a>

### Definition

Validators that have not been slashed but are no longer active.

| Name                         | MetricID             | Unit       | Interval      |
| ---------------------------- | -------------------- | ---------- | ------------- |
| Inactive Eligible Validators | ValidatorExtUnslhCnt | Validators | 1 day, 1 hour |

### Details

* Count of ETH Consensus Layer (CL) validators that have not been slashed but are no longer active.

### Release History

* Released September 2022.

### Availability for Assets

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

## Validators Pending Eligibility <a href="#validatorpndinitcnt" id="validatorpndinitcnt"></a>

### Definition

Validators pending eligibility.

| Name                           | MetricID            | Unit       | Interval      |
| ------------------------------ | ------------------- | ---------- | ------------- |
| Validators Pending Eligibility | ValidatorPndInitCnt | Validators | 1 day, 1 hour |

### Details

* Count of ETH Consensus Layer (CL) validators with ineligible status that are in the activation queue.

### Release History

* Released September 2022.

### Availability for Assets

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

## Validator in Activation Queue <a href="#validatorpndqedcnt" id="validatorpndqedcnt"></a>

### Definition

Validators waiting in the activation queue

| Name                           | MetricID           | Unit       | Interval      |
| ------------------------------ | ------------------ | ---------- | ------------- |
| Validators in Activation Queue | ValidatorPndQedCnt | Validators | 1 day, 1 hour |

### Details

* Count of ETH Consensus Layer (CL) validators that are waiting in the activation queue.

### Release History

* Released September 2022.

### Availability for Assets

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

## Full Participation Issuance <a href="#validatorpndqedcnt" id="validatorpndqedcnt"></a>

### Definition

Maximum daily protocol issuance on the Ethereum consensus layer (beacon chain) as a function of the number of active validators.

| Name                        | MetricID             | Unit         | Interval      |
| --------------------------- | -------------------- | ------------ | ------------- |
| Full Participation Issuance | IssFullParticipation | Native Units | 1 day, 1 hour |

### Release History

* Initially released November 2023.

### Availability for Assets

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

## API Endpoints

Validator metrics can be accessed using these endpoints:

* `timeseries/asset-metrics`

and by passing in the metric ID's `Validator*` 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=ValidatorActExtCnt&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=ValidatorActExtCnt&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="ValidatorActExtCnt", 
        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/validators.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.