Skip to main content
GET
/
options
/
oi
/
history
Total OI history (cursor-paginated)
curl --request GET \
  --url https://api.example.com/options/oi/history \
  --header 'X-API-Key: <api-key>'
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "version": "2.0",
    "timestamp": "2026-04-29T12:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.backquant.com/llms.txt

Use this file to discover all available pages before exploring further.

Cursor-paginated time-series of total / call / put open interest for the underlying. Use cursor pagination (?limit + ?before=<ts>) to walk backwards through history without missing rows or double-counting at page boundaries. The response carries next_cursor - pass it as ?before= on the next call to fetch the previous page. Useful for:
  • Detecting OI build-ups before major expirations
  • Backtest data feeds that need contiguous history
  • Spotting unwinds (sudden OI drops) coincident with price moves

​
See also

OI by expiry

OPEX calendar

Authorizations

​
X-API-Key
string
header
required

Your BackQuant API key (same key as v1)

Headers

​
X-API-Key
string | null

Query Parameters

​
symbol
enum<string>
default:BTCUSDT

Trading symbol: BTCUSDT, ETHUSDT, SOLUSDT, or HYPEUSDT.

Available options:
BTCUSDT,
ETHUSDT,
SOLUSDT,
HYPEUSDT
​
limit
integer
default:200

Maximum points returned (1–2000).

Required range: 1 <= x <= 2000
​
before
string | null

ISO timestamp cursor — exclusive upper bound for paging older.

Response

Successful Response