curl --compressed "https://api.coinmetrics.io/v4/timeseries/market-openinterest?start_time=2020-08-05T23:00:00Z&end_time=2020-08-06T00:00:00Z&paging_from=start&markets=bitmex-XBTUSD-future&pretty=true&api_key=<your_key>"{
"data": [
{
"market": "binance-BTCUSDT-future",
"time": "2020-08-05T23:04:50.421035000Z",
"contract_count": "35074.075",
"value_usd": "408810440.79225",
"database_time": "2020-08-05T23:04:50.606185000Z",
"exchange_time": "2020-08-05T23:03:59.417000000Z"
},
{
"market": "binance-BTCUSDT-future",
"time": "2020-08-05T23:19:10.016074000Z",
"contract_count": "35061.142",
"value_usd": "409113039.09552",
"database_time": "2020-08-05T23:19:10.749665000Z",
"exchange_time": "2020-08-05T23:19:00.458000000Z"
}
]
}Market open interest
Returns open interest for specified futures, options, and event-contract markets.
Results are ordered by tuple (market, time).
With type=event_contract, markets are ordered by normalized exchange and raw symbol; value_usd is null. Granularity uses a rolling time filter: the first row in traversal order is emitted, then rows are suppressed until the next threshold. In END traversal, a row exactly at the threshold is emitted. Event-contract pagination preserves the rolling threshold across pages, so changing page_size does not change the selected observations.
To fetch the next page of results use next_page_url JSON response field. Keep in mind that spot markets are not supported by this endpoint.
Note: The value_usd field in this endpoint was previously calculated using hardcoded logic that no longer reflects current contract specifications across all exchanges.
To address this, we have deprecated the value_usd field and introduced new, more accurate metrics available via the /timeseries/market-metrics endpoint.
These two metrics should be used as a replacement for the value_usd field going forward:
- open_interest_reported_future_usd to represent the notional value of open interest in U.S. dollars for futures markets
- open_interest_reported_option_notional_usd to represent the notional value of open interest in U.S. dollars for options markets
We also introduced open_interest_reported_option_market_value_usd to represent the market value of open interest in U.S. dollars for options markets.
curl --compressed "https://api.coinmetrics.io/v4/timeseries/market-openinterest?start_time=2020-08-05T23:00:00Z&end_time=2020-08-06T00:00:00Z&paging_from=start&markets=bitmex-XBTUSD-future&pretty=true&api_key=<your_key>"{
"data": [
{
"market": "binance-BTCUSDT-future",
"time": "2020-08-05T23:04:50.421035000Z",
"contract_count": "35074.075",
"value_usd": "408810440.79225",
"database_time": "2020-08-05T23:04:50.606185000Z",
"exchange_time": "2020-08-05T23:03:59.417000000Z"
},
{
"market": "binance-BTCUSDT-future",
"time": "2020-08-05T23:19:10.016074000Z",
"contract_count": "35061.142",
"value_usd": "409113039.09552",
"database_time": "2020-08-05T23:19:10.749665000Z",
"exchange_time": "2020-08-05T23:19:00.458000000Z"
}
]
}Authorizations
Query Parameters
Start of the time interval.
This field refers to the time field in the response.
Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z, 2006-01-20T00:00:00.000Z, 2006-01-20T00:00:00.123456Z, 2006-01-20T00:00:00.123456789Z, 2006-01-20, 20060120.
Inclusive by default.
UTC timezone by default. Z suffix is optional and timezone parameter has a priority over it.
If start_time is omitted, response will include time series from the earliest time available.
End of the time interval.
This field refers to the time field in the response.
Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z, 2006-01-20T00:00:00.000Z, 2006-01-20T00:00:00.123456Z, 2006-01-20T00:00:00.123456789Z, 2006-01-20, 20060120.
Inclusive by default.
UTC timezone by default. Z suffix is optional and timezone parameter has a priority over it.
If end_time is omitted, response will include time series up to the latest time available.
Timezone name for start_time and end_time timestamps.
This parameter does not modify the output times, which are always UTC.
Format is defined by TZ database.
"America/New_York"

