Skip to main content
POST
candleSnapshot | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "candleSnapshot" is used to fetch historical OHLCV candles for a coin and interval over a time window for charting and backtesting.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "candleSnapshot", "req": {...}}. Note the nested req object.
  • Each response contains at most 5,000 candles (per-response cap, not a retention limit); page by advancing startTime for 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.
Returns an array of OHLCV candles for a single coin and interval, bounded by a [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 a req 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’s startTime, 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.
Pick the coarsest interval that satisfies your use case - larger intervals cover more calendar time per 5,000-candle page, so a multi-year 1d backfill is a single request while the same range at 1m pages many times.
Last reviewed: 2026-06-16