> ## Documentation Index
> Fetch the complete documentation index at: https://kb.talostrading.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Velocity

## Contents

* [1 Year Active Supply Velocity](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/transactions/velocity.md#velactadj1yr)
* [1 Year Active Supply Velocity, Adj](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/transactions/velocity.md#velactadj1yr)
* [1 Year Current Supply Velocity](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/transactions/velocity.md#velcur1yr)
* [1 Year Current Supply Velocity, Adj](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/transactions/velocity.md#velcuradj1yr)

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

[https://coverage.coinmetrics.io/asset-metrics/VelAct1yr](https://coverage.coinmetrics.io/asset-metrics/VelAct1yr)

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

[https://coverage.coinmetrics.io/asset-metrics/VelActAdj1yr](https://coverage.coinmetrics.io/asset-metrics/VelActAdj1yr)

## 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)](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/transactions/transfer-value.md#txtfrval) for trailing 1 year / [Current Supply (native units)](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/supply/current-supply.md#splycur)

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

[https://coverage.coinmetrics.io/asset-metrics/VelCur1yr](https://coverage.coinmetrics.io/asset-metrics/VelCur1yr)

## 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)](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/transactions/transfer-value.md#txtfrvaladj) for trailing 1 year / [Current Supply (native units)](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/supply/current-supply.md#splycur)

### Chart

![https://charts.coinmetrics.io/network-data/#576](https://mintcdn.com/talos-trading/9m6tIKuinLLOp5jj/coinmetrics/images/Velocity_1_Yr,_Adjusted.png?fit=max\&auto=format\&n=9m6tIKuinLLOp5jj\&q=85\&s=05283b67b21efc674cd6e2bf48276d03)

### 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://kb.talostrading.com/coinmetrics/network-data/network-data-overview/transactions/velocity.md#velcur1yr)

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/VelCurAdj1yr](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.

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=VelAct1yr&assets=btc&pretty=true&api_key=<your_key>"
> ```

> [tab] Python
>
> ```python theme={null}
> 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)
> ```

> [tab] Python Client
>
> ```python theme={null}
> 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()
> )
> ```
