Validator Supply

Contents

• Supply Staked in Validators

• Sum of all Balances from Active Validators

• Total Staked Supply

Supply Staked in Validators

Definition

Supply staked in validators.

Name	MetricID	Unit	Interval
Supply Staked in Validators	SplyStkedNtv	Native Units	1 day, 1 hour

Details

• Sum of all balances from all eligible active validators (validators with 'active' or 'pending' status).

Release History

• Released September 2022.

Sum of all Balances from Active Validators

Definition

Supply from validators that were active that day.

Name	MetricID	Unit	Interval
Active Staking Supply	SplyActStkedNtv	Native Units	1 day, 1 hour

Details

• Sum of all balances from actively participating validators.

Release History

• Released September 2022.

Total Staked Supply

Definition

Sum of all balances held by all validators.

Name	MetricID	Unit	Interval
Total Staked Supply	SplyTotStkedNtv	Native Units	1 day, 1 hour

Details

• Sum of all balances held by all validators, regardless of status (i.e. rewarded supply, slashed supply, etc.)

Release History

• Released September 2022.

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.

Asset metrics

Returns requested metrics for specified assets. Results for block by block metrics (1b frequency) are ordered by tuple (asset, height, block_hash), all other metrics are ordered by tuple (asset, time). You can change the sorting using sort query parameter. Supported output formats are json (default) and csv, use format query parameter to override it. To fetch the next page of results use next_page_url JSON response field or x-next-page-url CSV HTTP header if present. If multiple metrics are requested in the same time the strict policy for partially available metrics among requested ones is applied:

GEThttps://api.coinmetrics.io/v4/timeseries/asset-metrics

Authorization

api_key

Query parameters

Response

200400401403414

Time series of metrics for an asset.

Body

application/jsontext/csv

data*any

next_page_tokenNextPageToken (string)

Token of the next page results for a given request.

next_page_urlNextPageUrl (string)

URL of the next page results for a given request.

Response

200400401403

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

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

Python

import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=SplyStkedNtv&assets=eth&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",
    ).to_dataframe()
)