candleSnapshot

Get OHLCV candlestick data for any coin and interval.

Currently we offer 1s candlesticks which are not available on Hyperliquid natively. Our candlesticks endpoint also return more than 5k last candles available through the native Hyperliquid API.

Overview

Returns OHLCV candle data for a given coin and interval. Uses the same candleSnapshot request type as Hyperliquid's native API, so existing integrations work with no code changes — just point at Hydromancer.

Request

  • Endpoint: POST /info

{
    "type": "candleSnapshot",
    "req": {
        "coin": "BTC",
        "interval": "1m",
        "startTime": 1700000000000,
        "endTime": 1700003600000
    }
}
Field
Type
Required
Description

coin

string

Yes

Coin name. For HIP-3 assets, prefix with dex name (e.g. "hyna:ETH")

interval

string

Yes

Candle interval (see valid intervals below)

startTime

number

Yes

Start time in milliseconds since epoch (inclusive)

endTime

number

Yes

End time in milliseconds since epoch (exclusive). Must be greater than startTime

limit

number

No

Maximum number of candles to return. Default and max: 5000

Valid intervals

Interval
Duration

1s

1 second

1m

1 minute

3m

3 minutes

5m

5 minutes

15m

15 minutes

30m

30 minutes

1h

1 hour

2h

2 hours

4h

4 hours

8h

8 hours

12h

12 hours

1d

1 day

3d

3 days

1w

1 week (Monday-aligned)

1M

1 month (calendar month)

1s candles are a Hydromancer addition — they are not available on the native Hyperliquid API. Requires Growth tier or above.

Response

Returns a JSON array of candle objects sorted by time ascending. Maximum 5000 candles per request.

Field
Type
Description

s

string

Coin name

i

string

Interval string

t

number

Candle open time (milliseconds, interval start)

T

number

Candle close time (milliseconds, interval end)

o

string

Open price

h

string

High price

l

string

Low price

c

string

Close (latest) price

v

string

Volume in base asset

q

string | null

Quote volume (notional value, sum of price * size). May be null — see note below

n

number

Number of trades

x

boolean

true if the candle is closed/finalized, false if still open

Differences from Hyperliquid's response: Hydromancer adds q (quote volume) and x (closed flag). Field names (s, i, t, T, o, h, l, c, v, n) are identical to Hyperliquid's format.

Rate limits

20 points per request (see rate limits).

Examples

Common errors

Error
Cause

Invalid interval

Interval string not in the valid list above

endTime must be greater than startTime

endTime <= startTime

Missing required field: coin

coin field not provided

Last updated