Market

Futures Open Interest History

Changed on

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.

get/gateway/v1/market/open-interest-history

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

symbolstring

Base ticker for cross-exchange futures history. Supply symbol alone or exchange and pair together.

Example:SUI
exchange'binance' | 'okx' | 'bybit' | 'bitget' | 'htx' | 'bitfinex' | 'hyperliquid'

Exchange for single perpetual contract history. Requires pair.

Example:binance
pairstring

Linear perpetual BASE/USDT (BASE/USDC for Hyperliquid). An explicit matching :SETTLE suffix is accepted. Requires exchange.

Example:SUI/USDT
interval'1h' | '4h' | '1d'

UTC candle interval.

fromstring

Inclusive window start (Unix seconds, YYYY-MM-DD or RFC3339), rounded up to the next candle boundary when unaligned. Omit for the latest candles.

Example:2025-12-20
limitinteger

Number of candle intervals in the window. Advance from by this many intervals for the next page, including when a candle is missing.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/SimpleListResponseMarketOpenInterestPoint.json"
}

Changes