# Aayat AI Perpetual Futures OHLCV Candles

> Aayat AI Perpetual Futures OHLCV Candles is a paid API for AI agents from aayatai.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-01).

Returns OHLCV candlestick data (up to 500 candles, 1m to 1d) for perpetual futures markets on Hyperliquid or dYdX, with a summary including price change, high/low, USD volume, and annualised realised volatility.

## Facts

- Endpoint: GET https://aayatai.com/perps/candles?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aayat-ai-perpetual-futures-ohlcv-candles-d5d65e68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_naYcgDr7BXo_dTE6UtTMv

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 aayat-ai-perpetual-futures-ohlcv-candles-d5d65e68
```

Example prompt: Can you pull the last 24 hourly candles for ETH perps from Hyperliquid, including the high/low, USD volume, and annualised realised volatility summary?

## When to prefer this

Choose this endpoint when you need historical OHLCV candlestick data specifically for perpetual futures (not spot markets) on Hyperliquid or dYdX, especially when you also want a pre-computed volatility summary. It is well-suited for quantitative agents that need price history and volatility metrics in a single call at low cost ($0.002 per call). Prefer it over generic market data APIs when targeting DeFi perp venues.

## Known failure modes

- Unknown coin symbol returns an error or empty candles array
- Requesting more than 500 candles is rejected (maximum limit enforced)
- If Hyperliquid is unavailable and venue=hyperliquid is forced, the call may fail (use venue=auto as fallback)
- Invalid interval value returns a validation error
- Network or upstream exchange outage may cause timeout or 5xx error

## How this service works

OHLCV candles for a perpetual futures market on Hyperliquid or dYdX (1m to 1d, up to 500), with a summary: change, high/low, USD volume and annualised realised volatility. Pass ?coin=ETH&interval=1h&limit=24 (&venue=dydx).

## Output

A list of OHLCV candlestick objects (open, high, low, close, volume) for the requested perpetual futures market, plus a summary object containing overall price change, period high/low, total USD volume, and annualised realised volatility calculated from the returned candles.

## 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"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "maxLength": 20,
       "description": "Market symbol, e.g. BTC, ETH, SOL."
      },
      "limit": {
       "type": "integer",
       "default": 24,
       "maximum": 500,
       "minimum": 2,
       "description": "How many of the latest candles (2-500)."
      },
      "venue": {
       "enum": [
        "auto",
        "hyperliquid",
        "dydx"
       ],
       "type": "string",
       "default": "auto",
       "description": "auto (default: Hyperliquid, or dYdX while Hyperliquid is unavailable), hyperliquid or dydx."
      },
      "detail": {
       "enum": [
        "full",
        "brief"
       ],
       "type": "string",
       "default": "full",
       "description": "brief = key fields only (same price)"
      },
      "interval": {
       "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "1d"
       ],
       "type": "string",
       "default": "1h",
       "description": "Candle size."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-perpetual-futures-ohlcv-candles-d5d65e68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)