REST API

Open Interest Data

Open interest data shows the total value of the derivative contracts that are open.

Download Open Interest Data

Download the hourly open interest data files for futures trading pairs.

GET/download

Example: Download BTCUSDT Open Interest

Terminal
curl "https://api.cryptohftdata.com/v1/download?file=binance_futures/2025-08-01/20/BTCUSDT_open_interest.parquet&api_key=your-api-key-here" \
  -o BTCUSDT_open_interest_20.parquet

Venue-specific semantics

  • OKX perpetual swaps: sum_open_interest is in contracts. Multiply it by ctVal (base coin for linear swaps, USD for inverse swaps). sum_open_interest_value is in USD.
  • Bitget Futures: sum_open_interest is in the base coin. From the 2026-09 data-integrity release, sum_open_interest_value is the open interest multiplied by the mark price. Before this release, the column was empty.
  • Kraken Futures: Inverse contracts (PI_, FI_) are USD contracts. From the 2026-09 data-integrity release, their sum_open_interest_value is the number of contracts multiplied by the contract size in USD. Earlier files multiplied it by the price. We corrected these files on 2026-09-30. Linear PF_ contracts are not affected.
  • Lighter: From the 2026-09 data-integrity release, sum_open_interest is in base units, and sum_open_interest_value is the USD notional. Earlier files had the USD notional in sum_open_interest. We corrected these files on 2026-09-30.
  • Binance Futures: Older open interest files can repeat snapshots that we already published in earlier hours. Remove duplicates on (symbol, timestamp). The SDK function get_open_interest already does this in each download. We plan a cleanup of the published history.
  • Bybit Futures: Before the 2026-09 data-integrity release, ticker, mark price and open interest rows were change-only deltas. A field that did not change in a message is null. An open interest file exists only for hours in which open interest changed. Forward-fill the values for each symbol, and look back into earlier hours if necessary. From the release, each row contains the full carried-forward state. After a collector loses its state, the first hour contains only the fields that the collector received during that hour.
  • Bybit Futures: From the 2026-09 data-integrity release, each symbol with a known open interest has a carried-forward row at the start of each hour. In this row, timestamp and received_time are both equal to the start of the hour. There is no flag column. Use these two values to identify the row.
  • Bybit, OKX: The published open interest comes from the WebSocket ticker and open-interest channels. We do not publish the output of the REST open-interest pollers.
  • BitMEX: Quantities are in raw units that are different for each instrument: XBTUSD in USD contracts, XBTUSDT in 1e-6 BTC, ETHUSDT in 1e-5 ETH, and spot pairs in 1e-8 of the base asset. Before you compare with other venues, check the multiplier of the instrument.

For missing hours, partial periods and pending corrections to published history, refer to Known Gaps & Corrections.

Futures Only

Open interest data is available only for futures/derivatives exchanges.

If you cannot find the information that you need, tell us. We also help with integrations.

Contact support