Skip to main content
GET
GET /perps/oi/history: Open-Interest History
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
OHLC of open interest in contracts for one instrument, bucketed at the interval you pick, plus the closing USD notional of each bucket. When the venue published no USD value for a bucket, oi_usd_close is null and carries its provenance — it is never a fabricated 0. Part of the Perps Data product; scope analytics.read.

Query Parameters

string
required
The instrument, by its venue-native id (for example 6) or its canonical symbol (for example BTC). Matches [A-Za-z0-9._-]{1,32}.
string
Bucket size: one of 1m, 5m, 15m, 1h, 4h, 1d. The interval sets the maximum window, below.
string
One of polymarket, binance, bybit, hyperliquid. Omit for the default. Polymarket is the covered venue.
string
Start of the window. Accepts RFC3339, unix seconds or unix milliseconds.
string
End of the window. Same formats as from. The maximum window depends on interval (below); a wider range is refused with 400 range_too_large.
integer
default:"1000"
Rows per page, 1–5000.
The maximum window is set by interval: 1m → 1 day, 5m → 7 days, 15m → 21 days, 1h → 90 days, 4h → 180 days, 1d → 400 days.

Response

Bars in data, one per interval, oldest first. When has_more is true, page forward by passing next_from_s (unix seconds) back as from.
string
The instrument the bars are for.
string
The bucket size actually used.
array
boolean
true when more rows remain beyond this page.
integer
Present when has_more is true. Unix seconds — pass it back as from to read the next page.

Example

  • Basis — mark, index and basis OHLC with the same parameters and ranges.
  • Perps Data overview — the product, its credential and shared conventions.