{"uid":"cap_CXdG2PUCDwqLxutKhVzhV","slug":"taifoon-ohlcv-candles-api-518b73da","name":"Taifoon OHLCV Candles API","description":"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).","url":"https://coord.taifoon.dev/v1/market/candles?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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)"}}}}}}},"responseSchema":{"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}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Mz5yo9jB4HIJGnPBGXr1R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV candlestick bars for BTC, ETH, SOL, NQ, ES, or YM across four timeframes, with a SHA-256 digest guaranteeing reproducibility.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Backtesting a crypto strategy","prompt":"Grab me the last 500 five-minute candles for ETH from an hour ago going back, I need open, high, low, close, and volume from the Taifoon tape for my backtest."},{"title":"Verifying CME futures data integrity","prompt":"Fetch the 1-hour OHLCV bars for NQ futures from 6 hours ago to 1 hour ago and give me the SHA-256 digest so I can confirm the data hasn't changed."},{"title":"Analyzing SOL price action","prompt":"Pull the 15-second candles for SOL on the Taifoon venue from exactly 30 minutes ago to 15 minutes ago — I want to inspect the micro price action around that window."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T18:34:46.881Z","isFirstParty":false,"canonicalSlug":"taifoon-ohlcv-candles-api-518b73da"}