Skip to main content

Returns

Contents​

ROI​

Definition​

The return on investment for the asset assuming a purchase 12 months prior.

NameMetricIDUnitInterval
ROI, 1 YearROI1yrDimensionless1 day, 1 hour
ROI, 30 DaysROI30dDimensionless1 day, 1 hour

Details​

Calculated as PriceUSD Change/PriceUSD Previous*100

Release History​

  • Released in the 1.0 release of NDP

Availability for Assets​

Embedded content

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

Asset metrics

View endpoint and parameters

Shell
curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=ROI1yr&assets=btc&pretty=true&api_key=<your_key>"
Python
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)
Python Client
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()
)