Hyperliquid perpetual exchange data endpoints, plus API documentation and monitoring.

Resources & endpoints

Hyperliquid Markets

Market Liquidations OHLCV

PREVIEW

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.

GET

https://api.pinax.network/v1/hyperliquid/markets/liquidations/ohlc

Requires bearer token — sign in to inject your team’s key.

Required parameters

Name	Type	Description
coinrequired query	string	Hyperliquid coin id. Perps: `BTC`. Spot: `@N` (`@107`). Builder DEXs: `xyz:SILVER`. Outcome coins (`#N`) are rejected — use `/v1/hyperliquid/outcomes/*`. e.g. BTC

Optional parameters

Name	Type	Description
dex query	Enum · 9	DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (`xyz`, `cash`, …). Outcome markets are served separately under `/v1/hyperliquid/outcomes/*`. perpsspotxyzcashkmhynaflxvntlpara
interval query	Enum · 8	The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly). *Plan restricted. 1m5m10m30m1h4h1d1w
start_time query	Datetime	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
end_time query	Datetime	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
limit query	integer	Number of items* returned in a single request. *Plan restricted.
page query	integer	Page number to fetch. Empty `data` array signifies end of results.

Response

200 OK

{
  "data": [
    {
      "timestamp": "2026-04-30 19:00:00",
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "interval_min": 60,
      "open": 76395,
      "high": 76395,
      "low": 76395,
      "close": 76395,
      "mark_price_open": 76390,
      "mark_price_high": 76390,
      "mark_price_low": 76390,
      "mark_price_close": 76390,
      "buy_volume": 16.81,
      "sell_volume": 0,
      "gross_volume": 16.81,
      "net_volume": 16.81,
      "open_long_volume": 0,
      "close_long_volume": 0,
      "open_short_volume": 16.81,
      "close_short_volume": 0,
      "transactions": 1,
      "unique_liquidators": 1,
      "unique_liquidated": 1,
      "total_fees": -0.000336
    }
  ]
}