# SperaxOS Binance Klines (OHLCV Candlestick) API

> SperaxOS Binance Klines (OHLCV Candlestick) API is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Fetches historical OHLCV candlestick (kline) data for a given trading pair from Binance, payable per-request via x402/USDC.

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/binance-market/getKlines?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-binance-klines-ohlcv-candlestick-api-0bd93c51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qelgnDxeKe_5hI8JvplC9

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 speraxos-binance-klines-ohlcv-candlestick-api-0bd93c51 -d '<json body>'
```

Example prompt: Pull the last 200 hourly OHLCV candles for BTC/USDT from Binance so I can run a technical analysis.

## When to prefer this

Use this endpoint when you need Binance OHLCV candlestick data payable per-call without an API key, especially in AI agent or DeFi workflows using the x402 payment protocol on Base. Prefer it over self-managed Binance API integrations when you want pay-as-you-go access without key management overhead.

## Known failure modes

- Invalid or unrecognized trading pair symbol returns an error
- Interval value outside supported options (e.g. typo) returns a validation error
- Limit outside 1–500 range may return an error or be clamped
- Payment via x402/USDC fails if wallet has insufficient USDC balance on Base
- Network or Binance upstream outage causes timeout or 5xx error

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns an ordered array of OHLCV (open, high, low, close, volume) candlestick records for the requested trading pair and interval, up to the requested limit (max 500). Each record includes timestamp, open, high, low, close, and volume fields sourced from Binance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "default": 100,
   "description": "Number of candles to return (1–500)."
  },
  "symbol": {
   "type": "string",
   "description": "Trading pair in any common form: \"BTCUSDT\", \"BTC/USDT\" or a bare \"BTC\" (a USDT quote is assumed)."
  },
  "interval": {
   "type": "string",
   "default": "1h",
   "description": "Candle interval: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w or 1M."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-binance-klines-ohlcv-candlestick-api-0bd93c51/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)