# HyperExtend OHLCV Candles API

> HyperExtend OHLCV Candles API is a paid API for AI agents from api.hyperextend.xyz, paid per call via x402, $0.051/call, status unknown (last checked 2026-09-15).

Returns OHLCV (Open, High, Low, Close, Volume) candlestick data for a given crypto asset and interval, optionally filtered by time window.

## Facts

- Endpoint: GET https://api.hyperextend.xyz/v1/candles/BTC/1m
- Price: $0.051/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperextend-ohlcv-candles-api-3e303e26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4PNoaebUVsvPtA7v8whJk

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 hyperextend-ohlcv-candles-api-3e303e26
```

Example prompt: Can you grab the most recent 1-minute BTC candles from HyperExtend, say the last 50 candles, so I can analyze the recent price action?

## When to prefer this

Choose this endpoint when you need raw OHLCV candlestick price data for a crypto asset at a specific interval (e.g. 1m, 5m) for charting, backtesting, or technical analysis. Prefer this over order book or funding rate endpoints when the primary need is historical or recent price candle data rather than market microstructure metrics.

## Known failure modes

- Invalid coin symbol returns an error or empty result
- Unsupported interval value causes a 400 bad request
- start timestamp after end timestamp results in empty or error response
- Requesting too many candles beyond limit cap may return partial data
- Payment not provided or insufficient USDC balance causes a 402 response

## How this service works

OHLCV candles over a window — main, spot, HIP-3 (e.g. xyz:AAPL, xyz:SP500) and HIP-4 outcome markets; intervals 1m to 1d. Priced per row ($0.00001 base for main/spot, $0.000025 premium for HIP-3/HIP-4); paginate with the X-Next-Start header (≤5000 rows/page). Candles lag ~2 days (reconstructed from the archive); omit start/end for the most-recent page.

## Output

A paginated list of OHLCV candlestick records for the requested asset and interval, each containing open, high, low, close, and volume values along with the candle timestamp. Omitting start/end returns the most recent page of candles.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "coin": "BTC",
   "interval": "1m"
  },
  "queryParams": {
   "limit": 50
  }
 }
}
```

## 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",
     "required": [
      "coin",
      "interval"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "description": "Asset symbol, e.g. BTC"
      },
      "interval": {
       "type": "string",
       "description": "Candle interval, e.g. 1m"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "dex": {
       "type": "string"
      },
      "end": {
       "type": "integer"
      },
      "limit": {
       "type": "integer"
      },
      "start": {
       "type": "integer"
      }
     }
    }
   },
   "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/hyperextend-ohlcv-candles-api-3e303e26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hyperextend.xyz](https://www.zero.xyz/host/api.hyperextend.xyz/llms.txt)