---
title: "Futures Open Interest History"
method: GET
path: "/gateway/v1/market/open-interest-history"
tags: ["Market"]
---

# Futures Open Interest History

`GET /gateway/v1/market/open-interest-history`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/market/open-interest-history`
- Auth: HTTP bearer

Returns USD open interest at each candle close across tracked futures exchanges for one symbol, or for one linear perpetual contract selected by exchange and pair. Missing candles are omitted. For a single contract snapshot use /exchange/perp.

## Query parameters

- `symbol` string: Base ticker for cross-exchange futures history. Supply symbol alone or exchange and pair together.
- `exchange` 'binance' | 'okx' | 'bybit' | 'bitget' | 'htx' | 'bitfinex' | 'hyperliquid': Exchange for single perpetual contract history. Requires pair.
- `pair` string: Linear perpetual BASE/USDT (BASE/USDC for Hyperliquid). An explicit matching :SETTLE suffix is accepted. Requires exchange.
- `interval` '1h' | '4h' | '1d': UTC candle interval.
- `from` string: Inclusive window start (Unix seconds, YYYY-MM-DD or RFC3339), rounded up to the next candle boundary when unaligned. Omit for the latest candles.
- `limit` integer: Number of candle intervals in the window. Advance from by this many intervals for the next page, including when a candle is missing.

## Response `200`

OK

- SimpleListResponseMarketOpenInterestPoint
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` MarketOpenInterestPoint[], nullable, required
    - `open_interest_usd` number, double, required: Open interest at the candle close, in USD. The current candle is provisional.
    - `timestamp` integer, required: Candle start time in Unix seconds (UTC).
  - `meta` ObjectResponseMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `data_through` integer: Latest timestamp (Unix seconds) covered by all returned time series
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable
    - `has_more` boolean: True when more recent data exists upstream than the response includes

## Other responses

- `default`: Error

## Changes

- **2026-11-20** `61be11261f42`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/changes/gateway/v1/market/open-interest-history/get.md)

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/61be11261f42?raw)
