GET
/
v1
/
perps
/
hyperliquid
/
markets
/
{symbol}
/
candles
Get Candles
curl --request GET \
  --url https://api.example.com/v1/perps/hyperliquid/markets/{symbol}/candles

Upstream Mapping

Maps to Hyperliquid’s POST /info with { "type": "candleSnapshot", "coin": "<symbol>", "interval": "<interval>" }.

Request

symbol
string
required
Market symbol (e.g., BTC)
interval
string
required
Candle interval: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w
startTime
number
Start timestamp in milliseconds
endTime
number
End timestamp in milliseconds

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/perps/hyperliquid/markets/BTC/candles?interval=1h"
Example Response
[
  {
    "open": "67500.0",
    "high": "67600.0",
    "low": "67450.0",
    "close": "67542.1",
    "volume": "1234.56",
    "timestamp": 1712000000000
  }
]