TradePortfolio
DocsCandles
Docs

Candles

Pro

GET /hip3-analytics/candles

OHLCV candles for a HIP-3 coin at a configurable interval. Returns open, high, low, close, and volume data for charting. Use it to build a price chart for a HIP-3 DEX token or feed a technical analysis pipeline. Note: this endpoint may return 503 if candle computation is temporarily disabled.

Authentication

Requires Pro tier or higher. Free and Dev tiers do not have access (returns 403).

Parameters

Query parameters

NameTypeRequiredDescription
coinstring✓Coin identifier in dex:symbol format, e.g. hyperliquid_dex:BTC.
intervalstring–Candle interval. Defaults to 1h.
startstring–ISO 8601 start timestamp. Defaults to the HIP-3 start date. Legacy start_time milliseconds is accepted until July 21, 2026.
endstring–ISO 8601 end timestamp. Legacy end_time milliseconds is accepted until July 21, 2026.
limitint–Maximum candles to return. Defaults to 500.

Example request

bash
curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip3-analytics/candles?coin=hyperliquid_dex:BTC&interval=1h&limit=24"

Example response

json
{
  "success": true,
  "coin": "hyperliquid_dex:BTC",
  "interval": "1h",
  "data": [
    {
      "timestamp": "2026-06-08T00:00:00Z",
      "open": 70900.00,
      "high": 71400.00,
      "low": 70750.00,
      "close": 71200.00,
      "volume": 4800000
    },
    {
      "timestamp": "2026-06-08T01:00:00Z",
      "open": 71200.00,
      "high": 71600.00,
      "low": 71100.00,
      "close": 71450.00,
      "volume": 5100000
    }
  ]
}

Errors

  • 403 — Your tier does not have access. Upgrade to Pro.
  • 503 — Candle computation is temporarily unavailable.

For authentication errors (401) and rate limit responses (429), see Errors.

Related