v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB

Market Data

Get historical candles

Retrieve historical OHLCV candle data for a market. Limited to 5000 candles per request.

get/v1/markets/{marketId}/candles

Path parameters

marketIdstring required

The market identifier

Query parameters

interval'1m' | '5m' | '15m' | '1h' | '4h' | '1d' required

fromnumber required

Start time (unix milliseconds)

tonumber

End time (unix milliseconds)

Response

Candle data

marketIdstring required

interval'1m' | '5m' | '15m' | '1h' | '4h' | '1d' required

Example response

{
  "marketId": "hyperliquid-btc-usdc",
  "interval": "1h",
  "candles": [
    {
      "openTime": 1704067200000,
      "closeTime": 1704070799999,
      "open": "42150.5",
      "high": "42500.0",
      "low": "42000.0",
      "close": "42350.25",
      "volume": "1234.56",
      "trades": 482
    }
  ]
}