Market Liquidations OHLCV

GET/v1/hyperliquid/markets/liquidations/ohlc

Returns liquidation-only OHLCV candles for a single coin and interval. Adds mark-price OHLC (mark_price_open, mark_price_high, mark_price_low, mark_price_close) — the price feed used for margining at liquidation time — alongside the standard trade-price OHLC. Volume and counts cover the liquidation fills only.

For all-fill candles, use /v1/hyperliquid/markets/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