# Reported Open Interest

## Overview

The open interest in U.S. dollars for various aggregations of futures markets and option markets. These metrics are available for assets, exchanges, exchange-assets, and pairs. These metrics are referred to as reported because the input data is reported open interest from centralized.

## Metrics

<table data-full-width="true"><thead><tr><th width="400">Metric</th><th>Description</th><th width="100">Frequency</th><th width="100">Coverage</th></tr></thead><tbody><tr><td><code>open_interest_reported_future_usd</code></td><td>The sum of all reported open interest from futures markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_future_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_future_tether_margined_usd</code></td><td>The sum of all reported open interest from futures markets where the margin asset is Tether in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_future_tether_margined_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_future_coin_margined_usd</code></td><td>The sum of all reported open interest from futures markets where the margin asset is equivalent to the underlying base asset in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_future_coin_margined_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_future_perpetual_usd</code></td><td>The sum of all reported open interest from perpetual futures markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_future_perpetual_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_future_nonperpetual_usd</code></td><td>The sum of all reported open interest from non-perpetual futures markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_future_nonperpetual_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_market_value_usd</code></td><td>The sum of all reported market value open interest from option markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_market_value_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_notional_usd</code></td><td>The sum of all reported notional open interest from option markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_notional_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_tether_margined_market_value_usd</code></td><td>The sum of all reported market value open interest from option markets where the margin asset is Tether in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_tether_margined_market_value_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_tether_margined_notional_usd</code></td><td>The sum of all reported notional open interest from option markets where the margin asset is Tether in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_tether_margined_notional_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_usdc_margined_market_value_usd</code></td><td>The sum of all reported market value open interest from option markets where the margin asset is USDC in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_usdc_margined_market_value_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_usdc_margined_notional_usd</code></td><td>The sum of all reported notional open interest from option markets where the margin asset is USDC in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_usdc_margined_notional_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_coin_margined_market_value_usd</code></td><td>The sum of all reported market value open interest from option markets where the margin asset is equivalent to the underlying base asset in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_coin_margined_market_value_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_coin_margined_notional_usd</code></td><td>The sum of all reported notional open interest from option markets where the margin asset is equivalent to the underlying base asset in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_coin_margined_notional_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_call_market_value_usd</code></td><td>The sum of all reported market value open interest from call option markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_call_market_value_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_call_notional_usd</code></td><td>The sum of all reported notional open interest from call option markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_call_notional_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_put_market_value_usd</code></td><td>The sum of all reported market value open interest from put option markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_put_market_value_usd">🔗</a></td></tr><tr><td><code>open_interest_reported_option_put_notional_usd</code></td><td>The sum of all reported notional open interest from put option markets in units of U.S. dollars.</td><td>1h, 1d</td><td><a href="https://coverage.coinmetrics.io/search-results?query=open_interest_reported_option_put_notional_usd">🔗</a></td></tr></tbody></table>

## Data Sources and Methodology

The input data source for the reported open interest metrics is open interest collected from centralized exchanges in Coin Metrics's coverage universe. The open interest is reported by exchanges in contract units and are converted to U.S. dollars and summed over the interval defined in the metric name.

Let us define the following notation:

* $$\mathrm{Q(T)}$$: open interest in contract units at time $$\mathrm{T}$$.
* $$\mathrm{S}$$: size of one contract (e.g. how many underlying units each contract represents).
* $$\mathrm{MarkPrice(T)}$$: mark price of the contract at time $$\mathrm{T}$$.
* $$\mathrm{ReferenceRate}\_{\mathrm{size}}(T)$$: price of one unit of the size asset in U.S. dollars at time $$\mathrm{T}$$
* $$\mathrm{ReferenceRate}\_{\mathrm{margin}}(T)$$: price of one unit of the margin asset in U.S. dollars at time $$\mathrm{T}$$.

The reported futures open interest metrics `open_interest_reported_future_*` are defined as:

$$
\mathrm{OpenInterestReportedFuture}(T)
;=;
Q(T)
;\times;
S
;\times;
\mathrm{ReferenceRate}\_{\mathrm{size}}(T)
$$

The reported option market value volume metrics `open_interest_reported_option_*_market_value` are defined as:

$$
\mathrm{OpenInterestReportedOptionMarketValue}(T)
;=;
Q(T)
;\times;
\mathrm{MarkPrice}(T)
;\times;
S
;\times;
\mathrm{ReferenceRate}\_{\mathrm{margin}}(T)
$$

The reported option notional volume metrics `open_interest_reported_option_*_notional_*` are defined as:

$$
\mathrm{OpenInterestReportedOptionNotional}(T)
;=;
Q(T)
;\times;
S
;\times;
\mathrm{ReferenceRate}\_{\mathrm{size}}(T)
$$

Coin Metrics calculates these metrics for various entities: assets, exchanges, exchange-assets, and pairs. For each entity, the markets used as input in the calculation differ. The entity defines a set of markets that are used in the calculation. The metric description further filters to a specific subset of markets as defined in the metric description.

* For **assets**, the markets included are any market where the asset is either the underlying base asset or underlying quote asset and match the markets in the metric description.
* For **exchanges**, the markets included are any market that is listed on the exchange and match the markets in the metric description.
* For **exchange-assets**, the markets included are any market that is listed on the exchange and the asset is either the underlying base asset or underlying quote asset and match the markets in the metric description.
* For **pairs**, the markets included are any market across all exchanges that contain the underlying pair and match the markets in the metric description.

## Coverage

{% embed url="<https://coverage.coinmetrics.io/search-results?query=open_interest_reported_%2A>" %}

## API Endpoints

The metrics are served through the following endpoints:

* [/timeseries/asset-metrics](https://docs.coinmetrics.io/api/v4/#tag/Timeseries/operation/getTimeseriesAssetMetrics)
* [/timeseries/exchange-metrics](https://docs.coinmetrics.io/api/v4/#tag/Timeseries/operation/getTimeseriesExchangeMetrics)
* [/timeseries/exchange-asset-metrics](https://docs.coinmetrics.io/api/v4/#tag/Timeseries/operation/getTimeseriesExchangeAssetMetrics)
* [/timeseries/pair-metrics](https://docs.coinmetrics.io/api/v4/#tag/Timeseries/operation/getTimeseriesPairMetrics)

## Examples

#### Example for Asset Metrics

A sample of the `open_interest_reported_future_usd` metric for the asset `btc` from our `/timeseries/asset-metrics` API endpoint is provided below. You can view this example in your browser [here](https://api.coinmetrics.io/v4/timeseries/asset-metrics?assets=btc\&metrics=open_interest_reported_future_usd\&limit_per_asset=3\&frequency=1d\&api_key=YOUR_API_KEY).

```json
[
  {
    "asset": "btc",
    "time": "2025-04-30T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "41162845558.7093"
  },
  {
    "asset": "btc",
    "time": "2025-05-01T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "40921372266.5667"
  },
  {
    "asset": "btc",
    "time": "2025-05-02T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "43111135716.4516"
  }
]
```

#### Example for Exchange Metrics

A sample of the `open_interest_reported_future_usd` metric for the exchange `binance` from our `/timeseries/exchange-metrics` API endpoint is provided below. You can view this example in your browser [here](https://api.coinmetrics.io/v4/timeseries/exchange-metrics?exchanges=binance\&metrics=open_interest_reported_future_usd\&limit_per_exchange=3\&frequency=1d\&api_key=YOUR_API_KEY).

```json
[
  {
    "exchange": "binance",
    "time": "2025-04-30T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "22632310225.3111"
  },
  {
    "exchange": "binance",
    "time": "2025-05-01T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "22352200663.6266"
  },
  {
    "exchange": "binance",
    "time": "2025-05-02T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "23747241307.732"
  }
]
```

#### Example for Exchange Asset Metrics

A sample of the `open_interest_reported_future_usd` metric for the exchange\_asset `binance-btc` from our `/timeseries/exchange-asset-metrics` API endpoint is provided below. You can view this example in your browser [here](https://api.coinmetrics.io/v4/timeseries/exchange-asset-metrics?exchange_assets=binance-btc\&metrics=open_interest_reported_future_usd\&limit_per_exchange_asset=3\&frequency=1d\&api_key=YOUR_API_KEY).

```json
[
  {
    "exchange_asset": "binance-btc",
    "time": "2025-04-30T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "11033512333.219"
  },
  {
    "exchange_asset": "binance-btc",
    "time": "2025-05-01T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "10728925269.4996"
  },
  {
    "exchange_asset": "binance-btc",
    "time": "2025-05-02T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "11693826293.528"
  }
]
```

#### Example for Pair Metrics

A sample of the `open_interest_reported_future_usd` metric for the pair `btc-usd` from our `/timeseries/pair-metrics` API endpoint is provided below. You can view this example in your browser [here](https://api.coinmetrics.io/v4/timeseries/pair-metrics?pairs=btc-usd\&metrics=open_interest_reported_future_usd\&limit_per_pair=3\&frequency=1d\&api_key=YOUR_API_KEY).

```json
[
  {
    "pair": "btc-usd",
    "time": "2025-04-30T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "20200281194.3809"
  },
  {
    "pair": "btc-usd",
    "time": "2025-05-01T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "20368237563.8639"
  },
  {
    "pair": "btc-usd",
    "time": "2025-05-02T00:00:00.000000000Z",
    "open_interest_reported_future_usd": "20753032443.369"
  }
]
```


---

# 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/market-data/market-data-overview/open_interest/open_interest_reported.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.
