# Hyperliquid OHLCV Candles

> Hyperliquid OHLCV Candles is a paid API for AI agents from hyperliquid.use.x402atlas.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns OHLCV candlestick data for a single Hyperliquid asset at a chosen interval (1m to 1M), with RFC3339 timestamps and full-precision price/volume strings.

## Facts

- Endpoint: GET https://hyperliquid.use.x402atlas.com/candles?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-ohlcv-candles-4f3101a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hZcyk5D0joqtjp88m59Mu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hyperliquid-ohlcv-candles-4f3101a3
```

Example prompt: Can you pull 1-hour OHLCV candles for BTC on Hyperliquid for the past week so I can do some technical analysis?

## When to prefer this

Use this endpoint when you need structured, named-field OHLCV candlestick data for a specific Hyperliquid asset at a defined interval, especially when RFC3339 timestamps and full-precision price strings are required. Prefer this over generic market data APIs when the asset trades on Hyperliquid (perps or spot) and you need interval flexibility from 1-minute to 1-month.

## Known failure modes

- Missing required 'coin' or 'interval' parameters returns a validation error
- Invalid coin symbol (not listed on Hyperliquid) returns an empty candle array or error
- Invalid interval value returns a schema validation error
- Start timestamp after end timestamp may return empty results or an error
- Very large time ranges may return truncated or empty data
- Payment failure (x402) blocks the request before execution

## How this service works

OHLCV candles for one Hyperliquid asset over any interval (1m to 1M), normalized into named fields with RFC3339 timestamps.

## Output

A JSON object containing the coin symbol, interval, count of candles returned, the timestamp when the query was made, and an array of candle objects each with open, high, low, close, volume (all as full-precision strings), trade count, open_time, and close_time in RFC3339 format.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin",
      "interval"
     ],
     "properties": {
      "end": {
       "type": "integer",
       "minimum": 0,
       "description": "Optional end (ms epoch); defaults to now"
      },
      "coin": {
       "type": "string",
       "maxLength": 32,
       "description": "Asset symbol (e.g. BTC)"
      },
      "start": {
       "type": "integer",
       "minimum": 0,
       "description": "Optional start (ms epoch); defaults to ~500 intervals ago"
      },
      "interval": {
       "enum": [
        "1m",
        "3m",
        "5m",
        "15m",
        "30m",
        "1h",
        "2h",
        "4h",
        "8h",
        "12h",
        "1d",
        "3d",
        "1w",
        "1M"
       ],
       "type": "string",
       "description": "Candle interval"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "coin": {
       "type": "string"
      },
      "count": {
       "type": "integer",
       "description": "Number of candles returned"
      },
      "candles": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "low": {
          "type": "string",
          "description": "Low price (string for full precision)"
         },
         "high": {
          "type": "string",
          "description": "High price (string for full precision)"
         },
         "open": {
          "type": "string",
          "description": "Open price (string for full precision)"
         },
         "close": {
          "type": "string",
          "description": "Close price (string for full precision)"
         },
         "trades": {
          "type": "integer",
          "description": "Number of trades in the candle"
         },
         "volume": {
          "type": "string",
          "description": "Volume (string for full precision)"
         },
         "open_tim
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "count": 1,
  "candles": [
   {
    "low": "63900.0",
    "high": "64300.0",
    "open": "64000.0",
    "close": "64250.0",
    "trades": 987,
    "volume": "1234.5",
    "open_time": "2026-07-10T11:00:00Z",
    "close_time": "2026-07-10T12:00:00Z"
   }
  ],
  "interval": "1h",
  "queried_at": "2026-07-10T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-ohlcv-candles-4f3101a3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid.use.x402atlas.com](https://www.zero.xyz/host/hyperliquid.use.x402atlas.com/llms.txt)