# Obol Market Candles — Verified OHLCV Candlestick Data

> Obol Market Candles — Verified OHLCV Candlestick Data is a paid API for AI agents from obol.danieldutoit.net, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns verified historical OHLCV candlestick data for a crypto trading pair (e.g. BTC/USD) from a specified exchange, settled via x402 micropayment in USDC on Base.

## Facts

- Endpoint: GET https://obol.danieldutoit.net/v1/markets/candles
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/obol-market-candles-verified-ohlcv-candlestick-data-300af091
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ajb53s94fcm5T2E2LFIoy

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 obol-market-candles-verified-ohlcv-candlestick-data-300af091
```

Example prompt: Can you pull the last 100 verified BTC/USD 60-second candlesticks from Kraken using Obol so I can analyze recent price action?

## When to prefer this

Choose this endpoint when you need verified, blockchain-settled OHLCV candlestick data for crypto markets and want payment handled automatically via x402 micropayments in USDC on Base. Prefer it over free APIs when data provenance and verification matter, or when building agent workflows that require trustless, pay-per-call access without API key management.

## Known failure modes

- Unsupported trading pair returns empty candles array
- Invalid or unsupported exchange name returns error
- Payment failure via x402 protocol blocks data access
- No recent data available results in null timestamps and zero returned candles
- Rate limiting or micropayment settlement delay causes timeout

## How this service works

Obol sells verified blockchain data over x402, settled in USDC on Base.

## Output

Returns a JSON object containing the base and quote currency pair, the candle period in seconds, the exchange name (e.g. KRAKEN), an array of OHLCV candles ordered newest-first, and a coverage object describing maximum candles available, number returned, and the latest and earliest observed timestamps. Includes a disclaimer that data is for informational use only.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "BTC",
  "quote": "USD",
  "period": 60,
  "candles": [],
  "coverage": {
   "order": "newest_first",
   "maximum_candles": 100,
   "returned_candles": 0,
   "latest_observed_at": null,
   "earliest_observed_at": null
  },
  "exchange": "KRAKEN",
  "disclaimer": "Historical exchange observations for informational use; not investment advice."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/obol-market-candles-verified-ohlcv-candlestick-data-300af091/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from obol.danieldutoit.net](https://www.zero.xyz/host/obol.danieldutoit.net/llms.txt)
