v1
latestOpenAPI 3.1.02026-07-2681217214.1 KBGet open interest
Open interest timeseries for a perpetual market (last sample per bucket). Query window capped at 7 days per request.
get/api/v1/markets/{market_id}/perps/open_interest
Path parameters
market_idstring required
Canonical market slug, {venue}:{instrument_type}:{pair}.
Query parameters
interval'1m' | '5m' | '15m' | '1h' | '4h' | '1d' required
Bucket interval.
start_timestampstring required
Start of the window (ISO 8601; naive datetimes treated as UTC).
end_timestampstring required
End of the window (ISO 8601).
limitinteger
Maximum rows to return (1–5000).
Response
Open interest samples.
Example response
{
"items": [
{
"market_id": "hl:perp:BTC-USDC",
"ts": "2026-05-01T01:00:00.000000+00:00",
"oi_base": "12483.50",
"oi_quote_usd": "1308734500.00"
}
]
}