Skip to content

Search API documentation

Metrics, companies & guides

Start here

Quickstart Authentication API plans & access Bitcoin prices & OHLCV data
Try

Bitcoin Futures Open Interest - All Exchanges API

Total USD value of all open futures contracts across major exchanges including Binance, BitMEX, Kraken, ByBit, and others

Request

GET
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/METRIC_NAME"
Parameters & responses
Query params

Authorization: Bearer YOUR_TOKEN (required) — your 24 character API key (also accepted: the X-API-Key header or the api_token query parameter).

resolution (optional) — 1d only for the metrics on this chart. A finer value is refused, never served as 1d: 401 when the token is not entitled to finer buckets, 400 when it is entitled and the metric does not ingest that bucket; see Resolutions.

before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Works on every resolution.

limit (optional) — the most recent N observations, maximum 5000. Finer resolutions page by default (2500); a 1d request returns the whole series unless you send limit or before.

before and limit narrow a time series. On a metric keyed by exchange or tenor they apply to each series, and the keys stay where they are. A response with no time axis, such as a labelled snapshot table, has nothing to cut on. It is returned whole, and both parameters are ignored rather than rejected.

A before that is not a positive epoch-millisecond timestamp is a 400. It is the one paging value we reject rather than ignore, because a page size has a sensible default and a cursor does not.

include (optional) — definition wraps the response as {"definition": …, "data": …} and returns the record shown under each metric; see Definitions. Any other value is a 400.

Path params

:metric_name — one of the metric names listed below.

Responses

200 with JSON payload, 400 for an unknown include value, 401 for missing/invalid token, 404 for missing resources, 429 when the monthly limit is reached. A 404 for a metric withdrawn on purpose adds withdrawn, withdrawn_on and reason, for example {"error":"Metric not found","withdrawn":true,"withdrawn_on":"2026-09-07","reason":"The venue's public feed reports insurance-fund settlements, not liquidation orders."}; a removed chart can add successor.

Plan and quota refusals keep their error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. The 429 for a used-up monthly allowance carries Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. A Pro token whose history window removed points also gets the X-Newhedge-History-Truncated headers, and for a Pro token X-Newhedge-Available-From is the start of the window. See Errors and plan limits.

Every 404 and 400 also carries a machine code and, where a list of valid names exists, up to 3 did_you_mean spellings, catalog_url and docs_url. Two different keys in one request are a 400 with code: conflicting_credentials. Only a successful response spends one call from the monthly allowance. A refused or failed call (any 4xx or 5xx, a conflict between credentials, an unknown path) spends nothing, and the request-rate limits are unchanged. The full list of codes is under Errors on the introduction page.

Metrics

One request per metric.

12 metrics
Metric

Binance Futures Open Interestoi_binance_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_binance_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,11806889624.517],
  [1735603200000,11871915224.1788],
  [1735689600000,12006826103.8111]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

OKX Futures Open Interestoi_okx_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_okx_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,3860176449.928],
  [1735603200000,3807924203.4136],
  [1735689600000,3845724572.7815]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

Deribit Futures Open Interestoi_deribit_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_deribit_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,2068268561.652],
  [1735603200000,2094520054.39],
  [1735689600000,2111948723.311]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

ByBit Futures Open Interestoi_bybit_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_bybit_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735430400000,7804439297.8224],
  [1735516800000,7697679509.7716],
  [1735689600000,7320491528.5978]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

BitMEX Futures Open Interestoi_bitmex_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_bitmex_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,469301624.968],
  [1735603200000,432204413.166],
  [1735689600000,424329585.0883]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional, stored as published.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-09-06

Metric

Bitget Futures Open Interestoi_bitget_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_bitget_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,15717741840.9287],
  [1735603200000,15462928244.8854],
  [1735689600000,14431574161.8896]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

Crypto.com Futures Open Interestoi_cryptocom_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_cryptocom_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2024-11-04
[
  [1730505600000,908197628.4507],
  [1730592000000,905920928.2684],
  [1730678400000,897272202.4764]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional, stored as published.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-09-06

Metric

KuCoin Futures Open Interestoi_kucoin_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_kucoin_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,610257383.6249],
  [1735603200000,582428201.5732],
  [1735689600000,559049780.6495]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

Gate.io Futures Open Interestoi_gateio_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_gateio_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,5053977808.3543],
  [1735603200000,5036202379.5762],
  [1735689600000,5180245172.377]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional, stored as published.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-09-06

Metric

Huobi Futures Open Interestoi_huobi_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_huobi_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,2767088409.3918],
  [1735603200000,2727189190.153],
  [1735689600000,2743917962.8598]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

Bitfinex Futures Open Interestoi_bitfinex_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_bitfinex_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,479181957.7331],
  [1735603200000,490563709.9887],
  [1735689600000,508303675.3877]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16

Metric

Kraken Futures Open Interestoi_kraken_futures

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-open-interest/oi_kraken_futures"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,246212767.6277],
  [1735603200000,246595187.2478],
  [1735689600000,248169058.1261]
]
Definition & units Definition

Value: Open interest of Bitcoin futures and perpetual contracts on the named venue, in US dollar notional. From 2026-09-17, a day the data provider leaves empty (and that is not later than the provider's latest published day) is Newhedge's own collected open interest for that venue: perpetual contracts plus dated futures where Newhedge collects them (Binance, OKX, Bybit, Deribit, Bitget, HTX, Kraken), perpetual contracts only otherwise (KuCoin, Bitfinex).

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: append_only. A stored day is never overwritten, with one exception. Before 2026-09-17 the values are the data provider's. From 2026-09-17, where the provider publishes no value for a day up to its latest published day, Newhedge fills the day from its own collected exchange data. If the provider later publishes a value for such a day, that value replaces the filled one. The two sources differ by a few percent on a given day, so the series can step at the changeover.

Universe: Bitcoin futures and perpetual contracts on the named venue.

Methodology version: 2026-10-16