Futures Open Interest History
Changed onReturns 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.
Request
- Base URLhttps://api.asksurf.ai
- AuthHTTP bearer
Query parameters
Base ticker for cross-exchange futures history. Supply symbol alone or exchange and pair together.
Exchange for single perpetual contract history. Requires pair.
Linear perpetual BASE/USDT (BASE/USDC for Hyperliquid). An explicit matching :SETTLE suffix is accepted. Requires exchange.
UTC candle interval.
Inclusive window start (Unix seconds, YYYY-MM-DD or RFC3339), rounded up to the next candle boundary when unaligned. Omit for the latest candles.
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
Example response
{
"$schema": "https://example.com/schemas/SimpleListResponseMarketOpenInterestPoint.json"
}Changes
- info
endpoint added
- info