# Velocity

## Contents

* [1 Year Active Supply Velocity](#velactadj1yr)
* [1 Year Active Supply Velocity, Adj](#velactadj1yr)
* [1 Year Current Supply Velocity](#velcur1yr)
* [1 Year Current Supply Velocity, Adj](#velcuradj1yr)

## 1 Year Active Supply Velocity <a href="#velact1yr" id="velact1yr"></a>

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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/VelAct1yr>" %}

## 1 Year Active Supply Velocity, Adj <a href="#velactadj1yr" id="velactadj1yr"></a>

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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/VelActAdj1yr>" %}

## 1 Year Current Supply Velocity <a href="#velcur1yr" id="velcur1yr"></a>

### 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)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/transactions/txtfrvalntv.md) for trailing 1 year / [Current Supply (native units)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/network-data-overview/transactions/broken-reference/README.md)

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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/VelCur1yr>" %}

## 1 Year Current Supply Velocity, Adj <a href="#velcuradj1yr" id="velcuradj1yr"></a>

### 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)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/transactions/txtfrvaladjntv.md) for trailing 1 year / [Current Supply (native units)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/network-data-overview/transactions/broken-reference/README.md)

### Chart

![https://charts.coinmetrics.io/network-data/#576](/files/-Mai7946HfgFMGZ8nyVC)

### 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](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/transactions/velcur1yr.md)

### Availability for Assets

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/VelCurAdj1yr>" %}

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

{% openapi src="/files/kc3C7O6zTLYNBA0AcsZt" path="/timeseries/asset-metrics" method="get" %}
[openapi.yaml](https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-a236d0d04b3b155748ce07a17aca8108fce9b7c2%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% tabs %}
{% tab title="Shell" %}

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

{% endtab %}

{% tab title="Python" %}

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

{% endtab %}

{% tab title="Python Client" %}

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

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/transactions/velocity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.