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

# Returns

### Contents

* [ROI, percent](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/market/returns.md#roi)

## ROI

### Definition

The return on investment for the asset assuming a purchase 12 months prior.[\
](https://docs.coinmetrics.io/info/metrics/ROI1yr)

| Name | MetricID | Unit | Interval |
| - | - | - | - |
| ROI, 1 Year | ROI1yr | Dimensionless | 1 day, 1 hour |
| ROI, 30 Days | ROI30d | Dimensionless | 1 day, 1 hour |

### Details

Calculated as PriceUSD Change/PriceUSD Previous\*100

### Release History

* Released in the 1.0 release of NDP

### Availability for Assets

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

### API Endpoints

Exchange Deposits metrics can be accessed using these endpoints:

* `timeseries/asset-metrics`

and by passing in the metric ID's `ROI*` in the `metrics` parameter.

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=ROI1yr&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=ROI1yr&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="ROI1yr", 
>         assets="btc",
>     ).to_dataframe()
> )
> ```
