DH
3 min read·Updated 2026-06-14

Query candles

OHLCV candle points for an asset and interval, with epoch-ms time and trade count.

GET/networks/{network}/markets/{asset}/candles

Candle points include epoch-millisecond time, ISO openTime, OHLC strings, volume, and trade count.

Path Params
networkstringrequired

Network identifier. Only hyperliquid is supported.

Example: hyperliquid

assetstringrequired

Canonical asset symbol or network symbol (e.g. BTC, ETH, xyz:SP500).

Example: BTC

Query Params
intervalstringrequired

Aggregation interval. Supported: 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M.

Example: 1h

fromstring

Start of the time window — ISO 8601 instant or epoch milliseconds.

Example: 2026-06-12T00:00:00Z

tostring

End of the time window — ISO 8601 instant or epoch milliseconds.

limitinteger

Maximum data points to return. Default 500, hard cap 5000.

Example: 500

cursorstring

Epoch-ms cursor from the previous page's nextCursor field.

Responses

200OK

OHLCV candle points for the requested interval and time window.

Schema
networkstring

Network identifier.

coinstring

Network asset symbol.

canonicalAssetstring

Canonical asset symbol.

intervalstring

Aggregation interval used.

candlesobject[]

OHLCV candle points, newest first.

timeinteger

Candle open time in epoch milliseconds.

openTimestring (ISO 8601)

Candle open time as an instant.

openstring

Open price.

highstring

High price.

lowstring

Low price.

closestring

Close price.

volumestring

Traded volume over the candle.

tradesinteger

Number of trades in the candle.

nextCursorstringnullable

Epoch-ms cursor for the previous window, or null at the start of history.

400Bad Request
401Unauthorized
404Not Found
500Server Error
Request
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/markets/BTC/candles?interval=1h&from=2026-06-12T00:00:00Z&to=2026-06-12T12:00:00Z&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"
Response
200 · OK
{
  "network": "hyperliquid",
  "coin": "BTC",
  "canonicalAsset": "BTC",
  "interval": "1h",
  "candles": [
    {
      "time": 1781262000000,
      "openTime": "2026-06-12T11:00:00Z",
      "open": "66820.0",
      "high": "67110.0",
      "low": "66740.5",
      "close": "67000.5",
      "volume": "1250.44",
      "trades": 18422
    }
  ],
  "nextCursor": "1781258400000"
}