Skip to main content
GET
GET /perps/basis: Mark, Index and Basis
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 the mark price, the index price and the basis (in basis points) for one instrument, bucketed at the interval you pick. premium_recomputed is null with provenance until the order-book layer exists; nothing is fabricated in its place. This endpoint takes the same parameters and the same interval-dependent ranges as open-interest history. 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