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

Resources & endpoints

Hyperliquid Markets

Market OHLCV

PREVIEW

Returns OHLCV candles for a single coin and interval, derived from regular trade fills. Volume is split into taker-buy and taker-sell (buy_volume, sell_volume) for the directional flow. On perpetuals, the four directional-intent fields (open_long_volume, close_long_volume, open_short_volume, close_short_volume) further classify 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.

GET

https://api.pinax.network/v1/hyperliquid/markets/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 23:00:00",
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "interval_min": 60,
      "open": 76184,
      "high": 76286,
      "low": 76178,
      "close": 76257,
      "buy_volume": 28447564.19,
      "sell_volume": 10848062.98,
      "gross_volume": 39295627.17,
      "net_volume": 17599501.21,
      "open_long_volume": 4495886.85,
      "close_long_volume": 11423420.07,
      "open_short_volume": 13640171.56,
      "close_short_volume": 5181222.62,
      "transactions": 5544,
      "unique_users": 1183,
      "total_fees": 111.23
    }
  ]
}