Hyperliquid Spot - Candles

Get spot OHLCV candles

Historical OHLCV candle data for a Hyperliquid spot pair, aggregated from archived spot trade data. Coverage matches archived spot trade history, beginning 2025-03-22.

Available Intervals: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w

Pagination: Use the cursor parameter with the value from the previous response's next_cursor.

get/v1/hyperliquid/spot/candles/{symbol}

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/hyperliquid/spot/candles/{symbol}
  • Auth: API key in header X-API-Key

Path parameters

symbolstring required
Example:PURR-USDC

Spot pair symbol. Accepts dashed canonical (PURR-USDC, HYPE-USDC), the wire-format coin (@107), or a bare base-token name (HFUN).

Query parameters

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Start timestamp. Defaults to 24h ago. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

End timestamp. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

interval'1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '1d' | '1w'

Candle interval (default: 1h)

cursorstring

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limitinteger

Maximum number of candles (default: 100, max: 10000).

Response

List of OHLCV candles with cursor for next page

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "timestamp": "2026-01-01T12:00:00Z",
      "open": 42500.5,
      "high": 42750,
      "low": 42300.25,
      "close": 42650.75,
      "volume": 1250.5,
      "quote_volume": 53187500,
      "trade_count": 4520
    }
  ],
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.