v1
latestOpenAPI 3.1.02026-07-2681217214.1 KBGet OHLCV candles
Historical OHLCV candles for a market. Query window capped at 7 days per request.
get/api/v1/markets/{market_id}/ohlcv
Path parameters
market_idstring required
Canonical market slug, {venue}:{instrument_type}:{pair}.
Query parameters
interval'1m' | '5m' | '15m' | '1h' | '4h' | '1d' required
Candle 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 candles to return (1–5000).
Response
Candles, ascending by time.
Example response
{
"items": [
{
"market_id": "hl:perp:BTC-USDC",
"open_time": 1746057600000,
"close_time": 1746061199999,
"open": "104120.00",
"high": "104880.50",
"low": "103990.10",
"close": "104830.10",
"volume": "1842.35",
"trade_count": 1234
}
]
}