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

# Staking Supply

## Contents

* [Supply Staked in Validators](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/supply/validator-supply.md#splystkedntc)
* [Active Staked Supply](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/supply/validator-supply.md#splyactstkedntv)
* [Total Staked Supply](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/supply/validator-supply.md#splytotstkedntv)
* [Average Supply Staked by Active Validators](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/supply/validator-supply.md#splystkedactmeanntv)

## Supply Staked by Stakers

### Definition

Supply staked in validators.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Supply Staked by Stakers (native units) | SplyStkedNtv | Native Units | 1 day, 1 hour |
| Supply Staked by Stakers (USD) | SplyStkedUSD | USD | 1 day |

### Details

* For Ethereum:
  * Sum of all balances from all eligible active validators (validators with 'active' or 'pending' status).
* For other assets:
  * Sum of all balances from all eligible stakers (delegators + validators)

### Release History

* Released September 2022.

## Active Staked Supply

### Definition

Supply from validators that were active that day.

<table><thead><tr><th>Name</th><th width="159">MetricID</th><th>Unit</th><th>Interval</th></tr></thead><tbody><tr><td>Sum of all balances from active stakers (native units)</td><td>SplyActStkedNtv</td><td>Native Units</td><td>1 day, 1 hour</td></tr><tr><td>Sum of all balances from active stakers (USD)</td><td>SplyActStkedUSD</td><td>USD</td><td>1 day</td></tr><tr><td>Sum of all balances from active delegators (native units)</td><td>SplyDelegatorActStkedNtv</td><td>Native units</td><td>1 day</td></tr><tr><td>Sum of all balances from active delegators (USD)</td><td>SplyDelegatorActStkedUSD</td><td>USD</td><td>1 day</td></tr><tr><td>Sum of all balances from active validators (native units)</td><td>SplyValidatorActStkedNtv</td><td>Native Units</td><td>1 day</td></tr><tr><td>Sum of all balances from active validators (USD)</td><td>SplyValidatorActStkedUSD</td><td>USD</td><td>1 day</td></tr></tbody></table>

### Details

* Sum of all balances from actively participating stakers.

### Release History

* Released September 2022.

## Total Staked Supply

### Definition

Sum of all balances held by all validators.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Total Staked Supply (native units) | SplyTotStkedNtv | Native Units | 1 day, 1 hour |
| Total Staked Supply (USD) | SplyTotStkedUSD | USD | 1 day |

### Details

* Sum of all actual balances held by validators whose active epoch range intersects the current interval. Unlike `SplyStkedNtv` and `SplyActStkedNtv`, this metric uses each validator's actual balance rather than effective balance.

### Release History

* Released September 2022.

## Average Supply Staked by Active Validators

### Definition

The mean supply held across all active stakers.

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| Average Supply Staked by Active Validators | SplyStkedActMeanNtv | Native units | 1 day |

### Details

* Mean staked supply per active validator, computed as `SplyActStkedNtv / ValidatorActOngCnt`.
* Provides a per-validator view of average stake size, useful for tracking consolidation and effective balance trends.

### Availability for Assets

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

## API Endpoints

Validator Supply metrics can be accessed using these endpoints:

* `timeseries/asset-metrics`

and by passing in the metric ID's `SplyStked*` in the `metrics` parameter.

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=SplyStkedNtv&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=SplyStkedNtv&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="SplyStkedNtv", 
>         assets="eth_cl",
>     ).to_dataframe()
> )
> ```
