candleSnapshot | Hyperliquid Info API
Info API
candleSnapshot | Hyperliquid Info API
Hyperliquid candleSnapshot: fetch historical OHLCV candles for a coin and interval over a time window for charting and backtesting.
POST
candleSnapshot | Hyperliquid Info API
Credit Cost
1 per call
Processing
Realtime
type: "candleSnapshot" is used to fetch historical OHLCV candles for a coin and interval over a time window for charting and backtesting.
- Wire-equal to
POST api.hyperliquid.xyz/infowith{"type": "candleSnapshot", "req": {...}}. Note the nestedreqobject. - Each response contains at most 5,000 candles (per-response cap, not a retention limit); page by advancing
startTimefor longer ranges. - GoldRush serves candles from a dedicated HyperCore historical store, so candles older than the upstream window can extend back to GoldRush’s full HyperCore coverage.
[startTime, endTime] window. Each candle carries the open/close timestamps, the coin, the interval, open/high/low/close prices, base volume, and trade count. Use it for chart backfills, indicator computation, and backtests.
This is a global, non-user-keyed type. NOT LIMITED TO THE MOST RECENT 5,000 CANDLES. GoldRush serves it from a dedicated HyperCore historical store so candles older than the upstream window remain available; page through time by advancing startTime.
Endpoint
Request
The request parameters are nested inside areq object.
string
default:"candleSnapshot"
required
Always
"candleSnapshot".object
required
The candle query parameters.
Example
Response
An array of candle objects, oldest first.Field descriptions
The price and volume fields (
o, c, h, l, v) are returned as decimal strings, preserving upstream precision. Do not parse them as floats.int
Candle open time, Unix milliseconds.
int
Candle close time, Unix milliseconds.
string
Coin symbol.
string
Candle interval - echoes the request
interval.string
Open price.
string
Close price.
string
High price.
string
Low price.
string
Base-asset volume over the candle.
int
Number of trades in the candle.
Paginating a large backfill
Each response returns at most 5,000 candles - a per-response cap, not a limit on how far back history goes. To backfill a range wider than 5,000 candles, page forward through time: start at your window’sstartTime, then set the next request’s startTime to the last candle’s close time (T) plus one millisecond. Repeat until a response returns fewer than 5,000 candles.
Because T is the inclusive close of a candle and the next candle opens at T + 1, advancing to T + 1 lands exactly on the following candle - no overlap to de-duplicate and no gaps.