{"uid":"cap_GusOm1Yh9K44y90RqPuju","slug":"tradesonar-candlestick-ohlcv-data-c1625936","name":"TradeSonar Candlestick OHLCV Data","description":"Candlesticks (1-minute minimum; no sub-minute)","url":"https://api.tradesonar.io/v1/markets/:ticker/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"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"Market ticker, e.g. ETH-USD (NOT ETH-USDT). See /v1/markets for valid tickers."}}},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"End time, ISO8601 (optional)"},"from":{"type":"string","description":"Start time, ISO8601 e.g. 2026-10-01T00:00:00Z (optional)"},"limit":{"type":"integer","default":200,"maximum":1000,"minimum":1,"description":"Max candles to return, 1-1000"},"resolution":{"type":"string","default":"1MIN","description":"Candle size: 1MIN/5MINS/15MINS/30MINS/1HOUR/4HOURS/1DAY (no sub-minute)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8RqspcGofihD8pD5x-QiJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 data for a market ticker at resolutions from 1 minute to 1 day","exampleAgentPrompt":"Pull the last 200 one-hour candles for ETH-USD from TradeSonar so I can run a technical analysis on recent price action.","exampleUseCases":[{"title":"Backtesting a trading strategy","prompt":"Get me daily OHLCV candles for BTC-USD from January 1st 2025 to today, up to 1000 bars, so I can backtest my moving-average crossover strategy."},{"title":"Real-time chart data for a dashboard","prompt":"Fetch the last 100 five-minute candles for ETH-USD ending now so I can render a live price chart."},{"title":"Overnight price range analysis","prompt":"Give me hourly candles for SOL-USD from 2025-06-01T00:00:00Z to 2025-06-02T00:00:00Z so I can see the overnight trading range and volatility."}],"resultDescription":"An array of candlestick (OHLCV) records for the requested market and resolution, each containing open, high, low, close prices and volume for the time bucket, ordered chronologically. The number of records is capped at the requested limit (default 200, max 1000).","failureModes":["Invalid or unsupported ticker returns an error — use /v1/markets to discover valid tickers (e.g. ETH-USD, not ETH-USDT)","Sub-minute resolution requested returns an error — minimum resolution is 1MIN","limit out of range (below 1 or above 1000) returns a validation error","Invalid ISO8601 format for from or to parameters returns a parsing error","Payment failure or insufficient USDC balance prevents the request from completing","Requesting a time range with no data (e.g. future dates or pre-listing dates) may return an empty array"],"whenToPreferThis":"Use this endpoint when you need structured OHLCV candlestick price history for a crypto market at minute-to-day granularity, especially for technical analysis, chart rendering, or strategy backtesting. Prefer this over tick-level or trade-level data when you need aggregated price buckets rather than individual fills. Not suitable for sub-minute data needs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:43:02.515Z","isFirstParty":false,"canonicalSlug":"tradesonar-candlestick-ohlcv-data-c1625936"}