Staking Supply

Contents

• Supply Staked in Validators
• Active Staked Supply
• Total Staked Supply
• Average Supply Staked by Active Validators

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.

Name	MetricID	Unit	Interval
Sum of all balances from active stakers (native units)	SplyActStkedNtv	Native Units	1 day, 1 hour
Sum of all balances from active stakers (USD)	SplyActStkedUSD	USD	1 day
Sum of all balances from active delegators (native units)	SplyDelegatorActStkedNtv	Native units	1 day
Sum of all balances from active delegators (USD)	SplyDelegatorActStkedUSD	USD	1 day
Sum of all balances from active validators (native units)	SplyValidatorActStkedNtv	Native Units	1 day
Sum of all balances from active validators (USD)	SplyValidatorActStkedUSD	USD	1 day

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

Embedded content

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

Asset metrics

View endpoint and parameters

openapi.yaml

Shell

curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=SplyStkedNtv&assets=eth_cl&frequency=1h&pretty=true&api_key=<your_key>"

Python

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)

Python Client

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