Skip to main content
POST
/
info
Candle snapshot
curl --request POST \
  --url https://api.hyperliquid.xyz/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "candleSnapshot",
  "req": {
    "coin": "BTC",
    "interval": "1h",
    "startTime": 1754300000000,
    "endTime": 1754400000000
  }
}
'
[
  {
    "T": 1681924499999,
    "c": "29258.0",
    "h": "29309.0",
    "i": "15m",
    "l": "29250.0",
    "n": 189,
    "o": "29295.0",
    "s": "BTC",
    "t": 1681923600000,
    "v": "0.98639"
  }
]
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet.
Retrieves historical candlestick (OHLCV) data for a specific asset within a time range. Only the most recent 5000 candles are available.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • type (string, required) — Must be "candleSnapshot"
  • req (object, required) — Request parameters:
    • coin (string, required) — Asset identifier (“BTC”, “ETH” for perpetuals; “@107” for spot)
    • interval (string, required) — Candle interval (see supported intervals below)
    • startTime (integer, required) — Start time in milliseconds (epoch timestamp)
    • endTime (integer, required) — End time in milliseconds (epoch timestamp)

​
Returns

Returns an array of candlestick objects with OHLCV data:
  • t — Open time timestamp (milliseconds)
  • T — Close time timestamp (milliseconds)
  • o — Open price (string)
  • h — High price (string)
  • l — Low price (string)
  • c — Close price (string)
  • v — Volume traded (string)
  • n — Number of trades (integer)
  • i — Interval (string)
  • s — Symbol (string)
Only the most recent 5000 candles are available. Older data beyond this limit is not accessible.

​
Supported intervals

"1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"

​
Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "type": "candleSnapshot",
    "req": {
      "coin": "BTC",
      "interval": "1h",
      "startTime": 1754300000000,
      "endTime": 1754400000000
    }
  }' \
  https://api.hyperliquid.xyz/info

​
Use cases

  • Technical analysis — Analyze price patterns and calculate technical indicators
  • Charting applications — Display candlestick charts with OHLCV data
  • Trading algorithms — Backtest strategies using historical price data
  • Market research — Study price movements and volatility patterns

Body

application/json
​
type
enum<string>
default:candleSnapshot
required

The request type. Must be 'candleSnapshot' to retrieve candle data.

Available options:
candleSnapshot
​
req
object
required

Request parameters object containing coin, interval, and time range

Response

200 - application/json

Successful response with candlestick data

​
T
integer<int64>
required

Close time timestamp in milliseconds

​
c
string
required

Close price as a string for precision

​
h
string
required

High price as a string for precision

​
i
string
required

Interval/timeframe of the candle

​
l
string
required

Low price as a string for precision

​
n
integer
required

Number of trades during this candle period

​
o
string
required

Open price as a string for precision

​
s
string
required

Symbol/asset identifier

​
t
integer<int64>
required

Open time timestamp in milliseconds

​
v
string
required

Volume traded during this candle period

Last modified on October 19, 2025