Candles

Candles are OHLCV bars at a chosen interval. Candle routes are published for Hyperliquid core, Spot, HIP-3, HIP-4, and Lighter. Unlike funding and open interest, candle values come back as numbers, not decimal strings.

Get candles

Hyperliquid
Spot
HIP-3
HIP-4
Lighter

curl "https://api.0xarchive.io/v1/hyperliquid/candles/BTC?interval=1h" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/hyperliquid/candles/{symbol}. Plain perp symbols such as BTC.

curl "https://api.0xarchive.io/v1/hyperliquid/spot/candles/HYPE-USDC?interval=1h" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/hyperliquid/spot/candles/{symbol}. Pair symbols such as HYPE-USDC.

curl "https://api.0xarchive.io/v1/hyperliquid/hip3/candles/km:US500?interval=1h" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/hyperliquid/hip3/candles/{symbol}. Namespaced builder symbols, case-sensitive.

curl "https://api.0xarchive.io/v1/hyperliquid/hip4/candles/%230?interval=1h" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/hyperliquid/hip4/candles/{symbol}. Outcome side ids such as %230; HIP-4 candles are a probability-history series.

curl "https://api.0xarchive.io/v1/lighter/candles/{symbol}?interval=1h" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/lighter/candles/{symbol}. Find symbols on /v1/lighter/instruments.

Request parameters

Parameter	In	Type	Required	Description
`symbol`	path	string	Yes	Trading pair symbol, e.g. `BTC`
`interval`	query	string	No	Candle interval. Default `1h`. One of `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1d`, `1w`
`start`	query	integer (ms)	No	Start time, Unix ms. Defaults to 24h ago
`end`	query	integer (ms)	No	End time, Unix ms. Defaults to now
`limit`	query	integer	No	Max results. Default 100, max 10000
`cursor`	query	string	No	Pagination cursor from `meta.next_cursor`

{
  "success": true,
  "data": [
    { "timestamp": "2026-06-04T18:00:00Z", "open": 63513, "high": 64117, "low": 63108, "close": 63788, "volume": 3507.95321, "quote_volume": 223506651.65, "trade_count": 44543 }
  ],
  "meta": { "count": 1, "next_cursor": "1780596000000", "request_id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb" }
}

Response fields

Candle values are numbers, not decimal strings.

Field	Type	Description
`timestamp`	string	Candle start time (ISO 8601 UTC)
`open`	number	Opening price
`high`	number	Highest price in the interval
`low`	number	Lowest price in the interval
`close`	number	Closing price
`volume`	number	Volume in the base asset
`quote_volume`	number	Volume in the quote asset (USD)
`trade_count`	integer	Number of trades in the interval

Gaps and intervals

Pick the largest interval that still answers the question; finer candles return more rows and more requests. A missing bar is not a zero bar, so confirm coverage on Data quality before a long historical pull, and treat a gap as a window to narrow or rebuild rather than fill. volume is in the base asset and quote_volume is in USD, so use quote_volume when comparing activity across symbols that trade at very different prices.

Replay it over WebSocket

Lighter lighter_candles supports historical WebSocket replay but not live subscriptions through the 0xArchive WebSocket. Current candles use REST; historical candle data is available through REST or WebSocket replay. For bulk file workflows, use the Trades export and aggregate to candles downstream. Hyperliquid core, Spot, HIP-3, and HIP-4 have no dedicated candle channel. HIP-4 candles are available through the REST route above as probability-history series.

ws.send(JSON.stringify({
  op: "replay",
  channel: "lighter_candles",
  symbol: "BTC",
  start: 1785193200000,
  end: 1785196800000,
  speed: 10
}));

Connection and reconnect handling live in the WebSocket tab; see WebSocket channels for the family matrix.

Export in bulk

Candles have no standalone export schema. For file-based history, export Trades with the trades schema and aggregate to candles downstream, or keep candle pulls on REST. Export schema details are on Export schemas.

Use Trades for the raw tape, Open interest for positioning, or Point-in-time backtesting to keep a candle pull reproducible.

Start

API

Exports

Data types

Venues

Data rights

Get candles

Request parameters

Response fields

Gaps and intervals

Replay it over WebSocket

Export in bulk

Next

​Get candles

​Request parameters

​Response fields

​Gaps and intervals

​Replay it over WebSocket

​Export in bulk

​Next

Get candles

Request parameters

Response fields

Gaps and intervals

Replay it over WebSocket

Export in bulk

Next