> ## Documentation Index
> Fetch the complete documentation index at: https://kb.talostrading.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stakers

## Contents

* [Count of Senders to CL Contract](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#sendercntclcont)
* [Total Unique Senders to CL Contract](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatoractextcnt)
* [Active Exiting Validators](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatoractextcnt)
* [Active Validators](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatoractongcnt)
* [Slashed Validators](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatoractslhcnt)
* [Stakers Count](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorcnt)
* [Daily Added Stakers ](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatoraddcnt1d)
* [Daily Removed Stakers](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorremcnt1d)
* [Inactive Ineligible Validators](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorextslhcnt)
* [Inactive Eligible Validators](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorextunslhcnt)
* [Validators Pending Eligibility](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorpndinitcnt)
* [Validator in Activation Queue](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorpndqedcnt)
* [Full Participation Issuance](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorpndqedcnt-1)
* [Staking Consolidations Count](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#stkconsolidationcnt)
* [Staking Consolidations Total](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#stkconsolidationtotntv)
* [Validator Consolidation Count](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorconsolidationcnt)
* [Validator Consolidation Rate](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorconsolidationrate)
* [Validator Total Consolidation Rate](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/staking/validators.md#validatorconsolidationtotrate)

## Count of Senders to CL Contract

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

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

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorActExtCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorActExtCnt)

## Active Validators

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorActOngCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorActOngCnt)

## Slashed Validators

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorActSlhCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorActSlhCnt)

## Stakers Count

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorCnt)

ValidatorCnt

[https://coverage.coinmetrics.io/asset-metrics/DelegatorCnt](https://coverage.coinmetrics.io/asset-metrics/DelegatorCnt)

DelegatorCnt

[https://coverage.coinmetrics.io/asset-metrics/StakerCnt](https://coverage.coinmetrics.io/asset-metrics/StakerCnt)

StakerCnt

## Daily Added Stakers

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorAddCnt1d](https://coverage.coinmetrics.io/asset-metrics/ValidatorAddCnt1d)

ValidatorAddCnt1d

[https://coverage.coinmetrics.io/asset-metrics/DelegatorAddCnt1d](https://coverage.coinmetrics.io/asset-metrics/DelegatorAddCnt1d)

DelegatorAddCnt1d

[https://coverage.coinmetrics.io/asset-metrics/StakerAddCnt1d](https://coverage.coinmetrics.io/asset-metrics/StakerAddCnt1d)

StakerAddCnt1d

## Daily Removed Stakers

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorRemCnt1d](https://coverage.coinmetrics.io/asset-metrics/ValidatorRemCnt1d)

ValidatorRemCnt1d

[https://coverage.coinmetrics.io/asset-metrics/DelegatorRemCnt1d](https://coverage.coinmetrics.io/asset-metrics/DelegatorRemCnt1d)

DelegatorRemCnt1d

[https://coverage.coinmetrics.io/asset-metrics/StakerRemCnt1d](https://coverage.coinmetrics.io/asset-metrics/StakerRemCnt1d)

StakerRemCnt1d

## Inactive Ineligible Validators

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorExtSlhCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorExtSlhCnt)

## Inactive Eligible Validators

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorExtUnslhCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorExtUnslhCnt)

## Validators Pending Eligibility

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorPndInitCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorPndInitCnt)

## Validator in Activation Queue

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

[https://coverage.coinmetrics.io/asset-metrics/ValidatorPndQedCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorPndQedCnt)

## Full Participation Issuance

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

[https://coverage.coinmetrics.io/asset-metrics/IssFullParticipation](https://coverage.coinmetrics.io/asset-metrics/IssFullParticipation)

## Staking Consolidations Count

### Definition

The count of all consolidations executed in the interval.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Staking Consolidations Count | StkConsolidationCnt | Consolidations | 1 day |

### Details

* Count of all validator consolidation requests executed on the Ethereum Consensus Layer during the interval.
* Consolidations were introduced in the Pectra upgrade (EIP-7251), allowing multiple validator keys to be merged into a single validator with a higher effective balance.

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/StkConsolidationCnt](https://coverage.coinmetrics.io/asset-metrics/StkConsolidationCnt)

## Staking Consolidations Total

### Definition

Total of all consolidations executed in the interval.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Staking Consolidations Total | StkConsolidationTotNtv | Native units | 1 day |

### Details

* Total value (in native units) of all validator consolidations executed on the Ethereum Consensus Layer during the interval.

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/StkConsolidationTotNtv](https://coverage.coinmetrics.io/asset-metrics/StkConsolidationTotNtv)

## Validator Consolidation Count

### Definition

The sum of all validators that had a consolidation request executed during the current interval.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Validator Consolidation Count | ValidatorConsolidationCnt | Validators | 1 day |

### Details

* Count of ETH Consensus Layer (CL) validators that were subject to a consolidation request during the interval.

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/ValidatorConsolidationCnt](https://coverage.coinmetrics.io/asset-metrics/ValidatorConsolidationCnt)

## Validator Consolidation Rate

### Definition

The relative rate at which validators consolidated during the current interval.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Validator Consolidation Rate | ValidatorConsolidationRate | Dimensionless | 1 day |

### Details

* Ratio of consolidated validators to total active validators during the interval.
* Computed as `ValidatorConsolidationCnt / ValidatorCnt`.

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/ValidatorConsolidationRate](https://coverage.coinmetrics.io/asset-metrics/ValidatorConsolidationRate)

## Validator Total Consolidation Rate

### Definition

The relative rate at which validators consolidated since the activation of the Pectra fork.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Validator Total Consolidation Rate | ValidatorConsolidationTotRate | Dimensionless | All time |

### Details

* Cumulative ratio of consolidated validators to total validators since the Pectra upgrade activated EIP-7251.

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/ValidatorConsolidationTotRate](https://coverage.coinmetrics.io/asset-metrics/ValidatorConsolidationTotRate)

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

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=ValidatorActExtCnt&assets=eth_cl&frequency=1h&pretty=true&api_key=<your_key>"
> ```

> [tab] Python
>
> ```python theme={null}
> import requests
> response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=ValidatorActExtCnt&assets=eth_cl&frequency=1h&pretty=true&api_key=<your_key>').json()
> print(response)
> ```

> [tab] Python Client
>
> ```python theme={null}
> from coinmetrics.api_client import CoinMetricsClient
>
> api_key = "<API_KEY>"
> client = CoinMetricsClient(api_key)
>
> print(
>     client.get_asset_metrics(
>         metrics="ValidatorActExtCnt", 
>         assets="eth_cl",
>     ).to_dataframe()
> )
> ```
