Skip to main content
POST
/
info
candleSnapshot | Hyperliquid Info API
curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "req": {
    "coin": "<string>",
    "interval": "<string>",
    "startTime": 123,
    "endTime": 123
  }
}
'
{
  "t": 123,
  "T": 123,
  "s": "<string>",
  "i": "<string>",
  "o": "<string>",
  "c": "<string>",
  "h": "<string>",
  "l": "<string>",
  "v": "<string>",
  "n": 123
}

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.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "candleSnapshot", "req": {...}}. Note the nested req object.
  • Each response contains at most 5,000 most recent candles.
  • For live, push-based candles, including HIP-3 and HIP-4 markets, use the Streaming API OHLCV streams instead of polling.
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. Page through time by advancing startTime.

​
Endpoint

POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json

​
Request

The request parameters are nested inside a req object.
​
type
string
default:"candleSnapshot"
required
Always "candleSnapshot".
​
req
object
required
The candle query parameters.

​
Example

curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "candleSnapshot",
    "req": {
      "coin": "BTC",
      "interval": "1h",
      "startTime": 1735689600000,
      "endTime": 1735776000000
    }
  }'

​
Response

An array of candle objects, oldest first. 
[
  {
    "t": 1735689600000,
    "T": 1735693199999,
    "s": "BTC",
    "i": "1h",
    "o": "62739.0",
    "c": "62960.0",
    "h": "63118.0",
    "l": "62711.0",
    "v": "921.9829",
    "n": 16396
  }
]

​
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.
​
t
int
Candle open time, Unix milliseconds.
​
T
int
Candle close time, Unix milliseconds.
​
s
string
Coin symbol.
​
i
string
Candle interval - echoes the request interval.
​
o
string
Open price.
​
c
string
Close price.
​
h
string
High price.
​
l
string
Low price.
​
v
string
Base-asset volume over the candle.
​
n
int
Number of trades in the candle.
Last reviewed: 2026-06-13