# Crypto OHLCV Candles API (agentshelf.syntexa.ch)

> Crypto OHLCV Candles API (agentshelf.syntexa.ch) is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Fetches OHLCV candlestick data for a spot trading pair at a given interval, aggregating across Coinbase Exchange, Kraken, OKX, and Binance with no API key required.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/crypto-candles?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-ohlcv-candles-api-agentshelf-syntexa-ch-7ac6b71c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lFaCeZO5-cqISiiWLIMbk

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 crypto-ohlcv-candles-api-agentshelf-syntexa-ch-7ac6b71c -d '<json body>'
```

Example prompt: Can you grab the last 50 hourly candles for BTC-USD so I can see recent price action?

## When to prefer this

Choose this endpoint when you need OHLCV candlestick data for a spot crypto pair without managing individual exchange API keys. It is ideal for agents that need a single unified interface across Coinbase, Kraken, OKX, and Binance with automatic fallback. Prefer this over direct exchange integrations when you want exchange-agnostic price history, need the 4h interval (skips Coinbase automatically), or want to avoid API key management overhead.

## Known failure modes

- Symbol not found on any of the four exchanges — returns an error or empty candle list
- Unsupported interval requested — rejected by schema validation before reaching exchanges
- Limit exceeds 500 — request rejected by input validation
- All four exchanges are unavailable or rate-limiting — upstream error propagated
- Payment not received or incorrect USDC amount — x402 payment required error

## How this service works

Call when an agent needs OHLCV candles for a spot symbol and interval (1m, 5m, 15m, 1h, 4h, 1d), limit up to 500. Tries Coinbase Exchange, Kraken, OKX, then Binance. No API key. Send JSON {"symbol":"BTC-USD","interval":"1h","limit":2}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/crypto-candles first.

## Output

A list of up to 500 OHLCV candle objects for the requested symbol and interval, each containing timestamp, open, high, low, close, and volume fields. The symbol in the response is normalized to BASE-QUOTE format. Data is sourced from the first available exchange among Coinbase Exchange, Kraken, OKX, and Binance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 100,
   "maximum": 500,
   "minimum": 1,
   "examples": [
    2
   ],
   "description": "How many candles to return, newest included. Example: 2. Default 100. At most 500."
  },
  "symbol": {
   "type": "string",
   "examples": [
    "BTC-USD"
   ],
   "maxLength": 24,
   "minLength": 5,
   "description": "Spot symbol. Example: BTC-USD or BTCUSDT. XBT is read as BTC. A slash is accepted. The response symbol is BASE-QUOTE."
  },
  "interval": {
   "enum": [
    "1m",
    "5m",
    "15m",
    "1h",
    "4h",
    "1d"
   ],
   "type": "string",
   "examples": [
    "1h"
   ],
   "description": "Candle size. One of 1m, 5m, 15m, 1h, 4h, or 1d. Coinbase has no 4h candles, so 4h uses the next venue."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-ohlcv-candles-api-agentshelf-syntexa-ch-7ac6b71c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)