# Hyperliquid Spot OHLCV Candles

> Hyperliquid Spot OHLCV Candles is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.02/call, status unknown (last checked 2026-09-10).

Returns historical OHLCV candlestick data for a Hyperliquid spot market token at a specified interval and time window

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/spot/candles/{token}
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-spot-ohlcv-candles-ee02105c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R4z8MdMLCUYYz8VhoPYkZ

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 agents-x402stock-xyz-hyperliquid-spot-ohlcv-candles-ee02105c
```

Example prompt: Can you pull the last 500 hourly OHLCV candles for HYPE on the Hyperliquid spot market?

## When to prefer this

Use this endpoint when you need historical candlestick price data specifically for Hyperliquid spot markets. Use the companion /api/v1/perps/candles/{coin} endpoint instead for Hyperliquid perpetual futures. Prefer this over generic crypto OHLCV endpoints when the target asset trades on Hyperliquid spot and you need fine-grained control over interval and lookback window without API key setup.

## Known failure modes

- Unknown or invalid token symbol returns an error or empty candle array
- Requesting more than 5000 candles via lookback is rejected
- Invalid interval enum value returns a validation error
- start or end timestamps out of range may return no data
- Network or upstream Hyperliquid data unavailability causes a service error
- Payment failure via x402 results in 402 response

## How this service works

Historical OHLCV candles for one Hyperliquid spot market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w) over a time window. Pass a token symbol (e.g. HYPE, PURR) or @index and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or `?start=`/`?end=` epoch-ms. Spot candles — for perp candles use /api/v1/perps/candles/{coin}. From x402stock

## Output

A JSON object containing the source identifier, as-of timestamp, venue, market type (spot), token pair, interval, candle count, and an array of OHLCV candles each with start time, end time, open, high, low, close, volume, and trade count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "token"
 ],
 "properties": {
  "end": {
   "type": "integer",
   "maximum": 9007199254740991,
   "exclusiveMinimum": 0
  },
  "start": {
   "type": "integer",
   "maximum": 9007199254740991,
   "exclusiveMinimum": 0
  },
  "token": {
   "type": "string",
   "description": "Hyperliquid spot token symbol, e.g. PURR."
  },
  "interval": {
   "enum": [
    "1m",
    "3m",
    "5m",
    "15m",
    "30m",
    "1h",
    "2h",
    "4h",
    "8h",
    "12h",
    "1d",
    "3d",
    "1w",
    "1M"
   ],
   "type": "string",
   "default": "1h"
  },
  "lookback": {
   "type": "integer",
   "default": 200,
   "maximum": 5000,
   "exclusiveMinimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "market",
  "pair",
  "id",
  "interval",
  "count",
  "candles"
 ],
 "properties": {
  "id": {
   "type": "string"
  },
  "pair": {
   "type": "string"
  },
  "as_of": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "venue": {
   "type": "string"
  },
  "market": {
   "type": "string",
   "const": "spot"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "candles": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "start",
     "end",
     "open",
     "high",
     "low",
     "close",
     "volume",
     "trades"
    ],
    "properties": {
     "end": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "low": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "high": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "open": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "close": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "start": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "trades": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "volume": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "additionalProperties": false
   }
  },
  "interval": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-spot-ohlcv-candles-ee02105c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)