Reported Open Interest

Contents

• Reported Coin Margined

• Reported Non-Perpetual

• Reported Perpetual

• Reported Tether Margined

• Reported Futures

Reported Coin-Margined Future Open Interest

Definition

The sum of all reported open interested from futures markets where the margin asset is equivalent to the underlying base asset in units of U.S. dollars.

Name	MetricID	Unit	Frequency
Reported Coin-Margined Future Open Interest	open_interest_reported_future_coin_margined_usd	USD	1h, 1d

Details

Our reported coin-margined future open interest metric is an aggregation of the reported coin-margined future open interest from all futures exchanges in CM's coverage universe. Covered exchanges can be found here.

Release History

• Release Version. Market Data Feed 2.4 (August 2021)

See Also

• Futures Contract Specifications

• Market Open Interest

• Reported Coin-Margined Future Volume

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Reported Non-Perpetual Future Open Interest

Definition

The sum of all reported open interest from non-perpetual futures markets in units of U.S. dollars.

Name	MetricID	Unit	Frequency
Reported Non-Perpetual Future Open Interest	open_interest_reported_future_nonperpetual_usd	USD	1h, 1d

Details

Our non-perpetual future open interest metric is an aggregation of the reported non-perpetual futures open interest from all futures exchanges in CM's coverage universe. Covered exchanges can be found here.

Release History

• Release Version. Market Data Feed 2.4 (August 2021)

See Also

• Futures Contract Specifications

• Market Open Interest

• Reported Non-Perpetual Future Volume

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Reported Perpetual Future Open Interest

Definition

The sum of all reported open interest from perpetual futures markets in units of U.S. dollars.

Name	MetricID	Unit	Frequency
Reported Perpetual Future Open Interest	open_interest_reported_future_perpetual_usd	USD	1h, 1d

Details

Our perpetual future open interest metric is an aggregation of the reported perpetual futures open interest from all futures exchanges in CM's coverage universe. Covered exchanges can be found here.

Release History

• Release Version. Market Data Feed 2.4 (August 2021)

See Also

• Futures Contract Specifications

• Market Open Interest

• Reported Perpetual Future Volume

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Reported Tether-Margined Future Open Interest

Definition

The sum of all reported open interest from futures markets where the margin asset is Tether in units of U.S. dollars.

Name	MetricID	Unit	Frequency
Reported Tether-Margined Future Open Interest	open_interest_reported_future_tether_margined_usd	USD	1h, 1d

Details

Our reported Tether-margined future open interest metric is an aggregation of the reported Tether-margined future open interest from all futures exchanges in CM's coverage universe. Covered exchanges can be found here.

Release History

• Release Version. Market Data Feed 2.4 (August 2021)

See Also

• Futures Contract Specifications

• Market Open Interest

• Reported Tether-Margined Future Volume

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Reported Future Open Interest

Definition

The sum of all reported future open interest from the spot markets in Coin Metrics' coverage in units of U.S. dollars.

Name	MetricID	Unit	Frequency
Reported Future Open Interest	open_interest_reported_future_usd	USD	1h, 1d

Details

Our reported future open interest metric is an aggregation of the reported future open interest from all futures exchanges in CM's coverage universe. Covered exchanges can be found here.

Release History

• Release Version. Market Data Feed 2.4 (August 2021)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

All reported open interest metrics can be queried using the following endpoints:

• /timeseries/asset-metrics

• /timeseries/exchange-metrics

• /timeseries/exchange-asset-metrics

• /timeseries/pair-metrics

and by passing in open_interest_reported_* metric ID's in the 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.

Response

200400401403

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

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

Python

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

Exchange metrics

Returns metrics for specified exchanges. Results are ordered by tuple (exchange, time). To fetch the next page of results use next_page_url JSON response field.

GEThttps://api.coinmetrics.io/v4/timeseries/exchange-metrics

Authorization

api_key

Query parameters

Response

200400401403414

Time series of exchange metrics.

Body

application/json

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.

Response

200400401403

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

curl --compressed "https://api.coinmetrics.io/v4/timeseries/exchange-metrics?metrics=open_interest_reported_future_coin_margined_usd&exchanges=binance&pretty=true&api_key=<your_key>"

Python

import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/exchange-metrics?metrics=open_interest_reported_future_coin_margined_usd&exchanges=binance&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_exchange_metrics(
        metrics="open_interest_reported_future_coin_margined_usd", 
        exchanges="binance",
        limit_per_exchange=5
    ).to_dataframe()
)

Exchange-asset metrics

Returns metrics for specified exchange-asset. Results are ordered by tuple (exchange_asset, time). To fetch the next page of results use next_page_url JSON response field.

GEThttps://api.coinmetrics.io/v4/timeseries/exchange-asset-metrics

Authorization

api_key

Query parameters

Response

200400401403414

Time series of exchange-asset metrics.

Body

application/json

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.

Response

200400401403

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

curl --compressed "https://api.coinmetrics.io/v4/timeseries/exchange-asset-metrics?metrics=open_interest_reported_future_coin_margined_usd&exchange_assets=binance-btc&pretty=true&api_key=<your_key>"

Python

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

Pair metrics

Returns metrics for specified asset pairs. Results are ordered by tuple (pair, time). To fetch the next page of results use next_page_url JSON response field.

GEThttps://api.coinmetrics.io/v4/timeseries/pair-metrics

Authorization

api_key

Query parameters

Response

200400401403414

Time series of pair metrics.

Body

application/json

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.

Response

200400401403

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

curl --compressed "https://api.coinmetrics.io/v4/timeseries/pair-metrics?metrics=open_interest_reported_future_coin_margined_usd&pairs=btc-usd&pretty=true&api_key=<your_key>"

Python

import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/pair-metrics?metrics=open_interest_reported_future_coin_margined_usd&pairs=btc-usd&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="open_interest_reported_future_coin_margined_usd", 
        pairs="btc-usd",
        limit_per_pair=5
    ).to_dataframe()
)