Hyperliquid

Market Candles

Returns market OHLCV candles for charting and trade-review overlays, ordered by open_time ascending. Each row also carries trades, closed, and nullable quote volume (null before quote-volume coverage). symbol, from, and to are required; from/to accept Unix seconds, ISO datetimes, or UTC dates, and candle open_time is bounded to the half-open [from,to) window. The requested window may contain at most 5000 candles, so use a larger interval for long histories. The response is market data and does not require a wallet address.

get/gateway/v1/hyperliquid/candles

Query parameters

symbolstring required

Hyperliquid market id (for example BTC, kPEPE, xyz:GOLD, the canonical PURR/USDC spot pair, or an @index spot market).

Example:SOL

Hyperliquid market id (for example BTC, kPEPE, xyz:GOLD, the canonical PURR/USDC spot pair, or an @index spot market).

interval'1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M'

Candle granularity.

Example:4h

Candle granularity.

fromstring required

Window start (Unix seconds, an ISO datetime, or a bare UTC date).

Example:2026-05-16

Window start (Unix seconds, an ISO datetime, or a bare UTC date).

tostring required

Window end (Unix seconds, an ISO datetime, or a bare UTC date; a bare date means the end of that day).

Example:2026-05-19

Window end (Unix seconds, an ISO datetime, or a bare UTC date; a bare date means the end of that day).

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseHyperliquidCandle.json"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.