Velocity

Contents

• 1 Year Active Supply Velocity

• 1 Year Active Supply Velocity, Adj

• 1 Year Current Supply Velocity

• 1 Year Current Supply Velocity, Adj

1 Year Active Supply Velocity

Definition

The ratio of the value transferred (i.e., the aggregate "size" of all transfers) in the trailing 1 year divided by active supply in the trailing 1 year. It can be thought of as a rate of turnover -- the number of times that an average native unit among the active supply has been transferred in the past 1 year.

Name	MetricID	Unit	Interval
1 Year Active Supply Velocity	VelAct1yr	Dimensionless	1 year

Release History

• Released in the 1.0 release of NDP

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

1 Year Active Supply Velocity, Adj

Definition

The ratio of the adjusted value transferred (i.e., the aggregate "size" of all transfers) in the trailing 1 year divided by active supply in the trailing 1 year. It can be thought of as a rate of turnover -- the number of times that an average native unit among the active supply has been transferred in the past 1 year.

Name	NameID	Unit	Interval
1 Year Active Supply Velocity, Adj	VelActAdj1yr	Dimensionless	1 year

Release History

• Released in the 1.0 release of NDP

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

1 Year Current Supply Velocity

Definition

The ratio of the value transferred (i.e., the aggregate "size" of all transfers) in the trailing 1 year divided by the current supply on that day. It can be thought of as a rate of turnover -- the number of times that an average native unit has been transferred in the past 1 year.

Name	MetricID	Unit	Interval
1 Year Current Supply Velocity	VelCur1yr	Dimensionless	1 year

Details

• Xfer'd Value (native units) for trailing 1 year / Current Supply (native units)

Release History

• Released in the 1.0 release of NDP

Interpretation

Velocity​ is a measurement of the rate at which an asset is exchanged. It can be thought of as a rate of turnover, or, in other words, the number of times that an average unit of an asset has been transferred within the last year. Our Adjusted Velocity metric removes noise and other artifacts from the transfer value in the numerator.

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

1 Year Current Supply Velocity, Adj

Definition

The ratio of the adjusted value transferred (i.e., the aggregate "size" of all transfers) in the trailing 1 year divided by the current supply on that day. It can be thought of as a rate of turnover -- the number of times that an average native unit has been transferred in the past 1 year.

Name	MetricID	Unit	Interval
1 Year Current Supply Velocity, Adj	VelCurAdj1yr	Dimensionless	1 year

Details

• Xfer'd Val, Adj (native units) for trailing 1 year / Current Supply (native units)

Chart

https://charts.coinmetrics.io/network-data/#576

Release History

• Released in the 1.0 release of NDP

Interpretation

Velocity​ is a measurement of the rate at which an asset is exchanged. It can be thought of as a rate of turnover, or, in other words, the number of times that an average unit of an asset has been transferred within the last year. In the above chart, we calculate velocity by dividing BTC’s adjusted transfer value over the past year (which is the total amount of cryptoasset transferred) by BTC’s total supply. Historically BTC’s velocity has increased during a rising bull cycle as on-chain activity increases, and has dipped following both the 2013 and 2017 price peaks. If velocity starts to slow dramatically, it could be read as a sign that the bull phase is reaching its end.

See Also

• 1 Year Current Supply Velocity

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

Token Transaction metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's VelAct1yr, VelActAdj1yr, etc. 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=VelAct1yr&assets=btc&pretty=true&api_key=<your_key>"

Python

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