# Taifoon OHLCV Candles API

> Taifoon OHLCV Candles API is a paid API for AI agents from coord.taifoon.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-17).

Returns historical OHLCV candlestick bars for BTC, ETH, SOL, NQ, ES, or YM across four timeframes, with a SHA-256 digest guaranteeing reproducibility.

## Facts

- Endpoint: GET https://coord.taifoon.dev/v1/market/candles?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/taifoon-ohlcv-candles-api-518b73da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CXdG2PUCDwqLxutKhVzhV

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 taifoon-ohlcv-candles-api-518b73da
```

Example prompt: Can you pull me the 1-minute OHLCV candles for BTC from the Taifoon tape for the window from 2 hours ago to 1 hour ago, and give me the SHA-256 digest so I can verify the data?

## When to prefer this

Use this endpoint when you need reproducible, verifiable historical OHLCV bars for crypto spot (BTC, ETH, SOL) or CME micro futures (NQ, ES, YM) with cryptographic integrity guarantees. It is ideal for backtesting, audit trails, or any workflow where you need to prove the data has not changed between calls. Prefer it over generic market data APIs when the SHA-256 digest and sealed-tape immutability are important properties.

## Known failure modes

- Requesting a window too close to the present (within 120 seconds of now) — tape only seals past windows
- Requesting more than 1,000 bars in a single call — results are capped
- Invalid market symbol or timeframe enum value returns an error
- Invalid or malformed timestamp parameters
- Payment failure or insufficient USDC balance results in 402 rejection

## How this service works

OHLCV bars of BTC, ETH, SOL or the CME micro futures NQ, ES, YM (15s, 1m, 5m, 1h) from the Taifoon venue tape, past windows only (up to 1,000 bars a call), with a sha256 digest of the bars. The tape seals a past window, so the same request gives the same bars. The same source is also served over MCP by Cubicle candles (ERC-8004 8453:96559).

## Output

An array of up to 1,000 OHLCV candle objects (each with timestamp, open, high, low, close, volume), bounded by the requested from/to window, plus a SHA-256 digest computed over the canonical 't,o,h,l,c,v' lines for tamper verification, and the market/timeframe echo.

## 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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "tf": {
       "type": "string"
      },
      "to": {
       "type": "string"
      },
      "from": {
       "type": "string"
      },
      "market": {
       "type": "string"
      }
     },
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "tf": {
       "enum": [
        "15s",
        "1m",
        "5m",
        "1h"
       ],
       "type": "string"
      },
      "to": {
       "type": "integer"
      },
      "from": {
       "type": "integer"
      },
      "digest": {
       "type": "string",
       "description": "sha256 over \"t,o,h,l,c,v\" lines"
      },
      "market": {
       "enum": [
        "BTC",
        "ETH",
        "SOL",
        "NQ",
        "ES",
        "YM"
       ],
       "type": "string"
      },
      "candles": {
       "type": "array",
       "description": "[{ t, o, h, l, c, v }], at most 1000; past windows only (to ≥ 120 s before now)"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tf": "1h",
  "to": 1791115200,
  "bars": 24,
  "from": 1791028800,
  "class": "market.candles",
  "digest": "0x…",
  "market": "ETH",
  "sealed": true,
  "candles": [
   {
    "c": 2698.87,
    "h": 2701.44,
    "l": 2698.87,
    "o": 2699.86,
    "t": 1791115200,
    "v": 31.325
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/taifoon-ohlcv-candles-api-518b73da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coord.taifoon.dev](https://www.zero.xyz/host/coord.taifoon.dev/llms.txt)