# x402stock Hyperliquid Spot OHLCV Candles

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

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?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-hyperliquid-spot-ohlcv-candles-a350829b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_saeHnwBdYBntS7q2ZGdPm

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 x402stock-hyperliquid-spot-ohlcv-candles-a350829b
```

Example prompt: Pull the last 500 hourly OHLCV candles for HYPE on the Hyperliquid spot market so I can analyze the recent price trend.

## When to prefer this

Use this endpoint when you need historical OHLCV candlestick data specifically for Hyperliquid spot markets. It supports flexible time windowing via lookback count or epoch-ms start/end, and a wide range of intervals from 1-minute to weekly. For Hyperliquid perpetuals candles, use the sibling perp candles endpoint instead.

## Known failure modes

- Invalid or unknown token symbol returns an error or empty result
- lookback exceeding 5000 candles is rejected
- Invalid interval string returns a validation error
- start/end epoch-ms values out of range or inverted may return empty data
- Network or upstream Hyperliquid API unavailability causes 5xx errors
- Requesting candles for a perp market via this endpoint returns incorrect or no data — use /api/v1/perps/candles/:coin instead

## 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

An array of OHLCV candlestick objects for the requested Hyperliquid spot token, each containing open, high, low, close, and volume values along with a timestamp, covering the specified interval and lookback window or start/end time range.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "token": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "end": {
       "type": "integer",
       "maximum": 9007199254740991,
       "exclusiveMinimum": 0
      },
      "start": {
       "type": "integer",
       "maximum": 9007199254740991,
       "exclusiveMinimum": 0
      },
      "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
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-hyperliquid-spot-ohlcv-candles-a350829b/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)