# x402stock Perpetual Futures OHLCV Candles

> x402stock Perpetual Futures 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-23).

Returns historical OHLCV candlestick data for a specified perpetual futures market on Hyperliquid DEX at a chosen time interval and lookback window.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/perps/candles/:coin?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-perpetual-futures-ohlcv-candles-6add8979
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SMekaB0YOACtz84Xv_vW8

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-perpetual-futures-ohlcv-candles-6add8979
```

Example prompt: Pull the last 500 daily candles for BTC perpetual futures from Hyperliquid so I can analyze the price trend over time.

## When to prefer this

Choose this endpoint when you need free, no-key-required historical OHLCV candlestick data specifically for perpetual futures markets on the Hyperliquid on-chain DEX. It is ideal for technical analysis, backtesting trading strategies, or monitoring price trends across a wide range of intervals from 1-minute to monthly. Prefer it over spot candle endpoints when working with perpetual derivatives rather than spot markets.

## Known failure modes

- Invalid coin symbol returns an error or empty result
- Lookback exceeding 5000 raises a validation error
- Invalid interval value not in the supported enum returns an error
- Start/end timestamps out of range or malformed return an error
- Network or upstream Hyperliquid DEX unavailability causes a timeout or 5xx error

## How this service works

Historical OHLCV candles for one perpetual-futures market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, and more) over a time window. Pass the coin in the path (e.g. BTC) and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or an explicit `?start=`/`?end=` epoch-ms range. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock

## Output

Returns an array of OHLCV candlestick objects for the requested perpetual futures market, each containing open, high, low, close, and volume values along with the candle's timestamp, covering the specified interval and lookback window or explicit 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": {
     "coin": {
      "type": "string"
     },
     "type": "object"
    },
    "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-perpetual-futures-ohlcv-candles-6add8979/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)