{"uid":"cap_lFaCeZO5-cqISiiWLIMbk","slug":"crypto-ohlcv-candles-api-agentshelf-syntexa-ch-7ac6b71c","name":"Crypto OHLCV Candles API (agentshelf.syntexa.ch)","description":"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.","url":"https://agentshelf.syntexa.ch/v1/crypto-candles?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"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_bYMZrCDNSoievFYzpRurp","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":"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.","exampleAgentPrompt":"Can you grab the last 50 hourly candles for BTC-USD so I can see recent price action?","exampleUseCases":[{"title":"Crypto trading signal analysis","prompt":"Get me the last 200 fifteen-minute candles for ETH-USD so I can run a moving average calculation on the close prices."},{"title":"Daily price summary for portfolio tracker","prompt":"Fetch the last 30 daily candles for SOL-USD — I want to chart the open, high, low, and close for the past month."},{"title":"Real-time scalping data feed","prompt":"Pull the last 10 one-minute candles for BTC-USD right now so I can check whether there's been a sharp move in the last few minutes."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:15:13.666Z","isFirstParty":false,"canonicalSlug":"crypto-ohlcv-candles-api-agentshelf-syntexa-ch-7ac6b71c"}