Market OHLCV

GET/v1/hyperliquid/markets/ohlc

Returns OHLCV candles for a single coin and interval, derived from regular trade fills. Volume is broken down both by side (buy_volume, ask_volume) and — on perpetuals — by directional intent (open_long_volume, close_long_volume, open_short_volume, close_short_volume) so consumers can distinguish whether price moves are driven by fresh exposure or position unwinds. On spot markets the directional-intent fields are zero; the side-volume fields carry the buy/sell breakdown directly.

For liquidation-only candles (with mark-price OHLC), use /v1/hyperliquid/markets/liquidations/ohlc.

Query Parameters

Parameter	Description	Value
`coin` string	Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`).	Required
`dex` string	DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set.
`interval` string	The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly). *Plan restricted. Default value: `1d` Accepted values: `1m`, `5m`, `10m`, `30m`, `1h`, `4h`, `1d`, `1w`	1d
`start_time` string	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
`end_time` string	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
`limit` integer	Number of items* returned in a single request. *Plan restricted. Default value: `10` Minimum value: `1` Maximum value: `1000`
`page` integer	Page number to fetch. Empty `data` array signifies end of results. Default value: `1` Minimum value: `1` Maximum value: `767465558638`

Potential Responses

Status	Description
200	Successful Response
400	Client side error
401	Authentication failed
403	Forbidden
404	Not found
500	Server side error