Future Expected Supply

Contents

• 10 Year Expected Supply, Adj (native units)

• Expected Future Supply

10 Year Expected Supply, Adj (native units)

Definition

This metric is an improved version of the legacy SplyExpFut10yr metric as it is better suited for use-cases that require a high degree of standardization, such as multi-asset indexes. As part of the v4.7 release, Coin Metrics has taken additional steps to harmonize the treatment of expected future supply across different token models. We have implemented these improvements in a this new metric; SplyExpFut10yrCMBI.

Name	MetricID	Unit	Interval
10 Year Expected Supply, Adj (native units)	SplyExpFut10yrCMBI	Native units	10 years

Details

• Expected future supply is computed by extrapolating the behavior of the currently active monetary policy.

• The CMBI version of this metric takes extra steps to guarantee heuristics are uniformly applied to various cryptoassets.

• Only implemented and programmatically defined supply inflation levels are considered. Any proposed or speculative inflation changes are not included until they are implemented in the source code as historically delays and governance processes have hindered such changes in a protocol’s monetary policy. Even if future changes in monetary policy are announced, they are only taken into account once they are enforced by the protocol.

• Unless lost, burned, or vested on-chain beyond 10 years, all current on-chain supply will be deemed liquid supply in 10 years time. Coin Metrics has taken this approach to account for the unpredictability associated with determining what holders of restricted supply will do over the next 10 years. e assets, estimating this number relies on too many assumptions (staking ratio, etc..), in which case it is not computed.

Release History

• Released in the 4.7 release of NDP

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

10 Year Expected Supply (native units)

Definition

The sum of all native units counting current supply and including all those expected to be issued over the next 10 years from that day if the current known continuous issuance schedule is followed. Future expected hard-forks that will change the continuous issuance are not considered until the day they are activated/enforced.

Name	MetricID	Unit	Interval
10 Year Expected Supply (native units)	SplyExpFut10yr	Native units	10 years
10 Year Expected Supply (native units)	SplyExpFut10yr	Native units	10 years

Details

• Expected future supply is computed by extrapolating the behavior of the currently active monetary policy.

• Even if future changes in monetary policy are announced, they are only taken into account once they are enforced by the protocol.

• For some assets, estimating this number relies on too many assumptions (staking ratio, etc.), in which case it is not computed.

Release History

• Released in the 1.0 release of NDP

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

Expected Future Supply metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's SplyExpFut* 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.

Request

ShellPython

curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?assets=btc&metrics=PriceUSD,FlowInGEMUSD&frequency=1d&pretty=true&api_key=<your_key>"

Response

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

Shell

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

Python

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