{"uid":"cap_ae-zcTZKAq6hDI3I3GWAp","slug":"halowerk-marktwerk-candles-81bb506e","name":"HALOWERK marktwerk Candles","description":"Returns open, high, low, close, volume and, where the exchange reports it, the trade count per candle. Timestamps are always the opening time of the candle in UTC milliseconds. The last candle is usually still forming: it is delivered but marked, and complete=false says so at the top level, with last_closed_ts naming the newest closed candle. Gaps are reported in gaps[] and never interpolated. A limit above the exchange page size is fetched in several requests and joined without a visible seam. ","url":"https://markt.halowerk.com/candles?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":100,"maximum":1000,"minimum":1,"description":"Number of candles, newest last."},"since":{"type":"string","format":"date-time","description":"Optional ISO start time. Without it the newest candles are returned."},"venue":{"enum":["binance","coinbase","kraken","okx","bybit"],"type":"string","default":"binance","description":"Exchange to read from."},"symbol":{"type":"string","pattern":"^[A-Za-z0-9]{2,15}/[A-Za-z0-9]{2,15}$","description":"Trading pair as BASE/QUOTE, for example ETH/USDC."},"interval":{"enum":["1m","5m","15m","1h","4h","1d"],"type":"string","description":"Candle size."}}},"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_r4XPR20DU6H0EuxTjti-M","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 OHLCV candle data (open, high, low, close, volume, trade count) for a trading pair from a specified exchange, with gap reporting and partial-candle flagging.","exampleAgentPrompt":"Pull the last 200 hourly candles for ETH/USDC on Coinbase — I need open, high, low, close, and volume, and flag if the most recent one is still forming.","exampleUseCases":[{"title":"Backtesting a crypto trading strategy","prompt":"Get me 1000 daily candles for BTC/USDT on Binance going back from today — I need OHLCV data to backtest a moving average crossover strategy, and let me know if there are any gaps."},{"title":"Monitoring intraday price action","prompt":"Fetch the last 96 four-hour candles for SOL/USDT on Bybit so I can chart recent price action and see where we are relative to the current forming candle."},{"title":"Analyzing volume spikes on a short timeframe","prompt":"Give me the most recent 500 five-minute candles for ETH/USDT on OKX starting from 2024-01-15T00:00:00Z — I want to compare volume across each bar and check for any data gaps."}],"resultDescription":"A JSON response containing an array of OHLCV candles (timestamp in UTC milliseconds, open, high, low, close, volume, and optionally trade count), a top-level complete flag indicating whether the newest candle is still forming, last_closed_ts identifying the newest fully closed candle, and a gaps[] array listing any time ranges where data is missing.","failureModes":["Invalid symbol format (must match BASE/QUOTE pattern) returns a validation error","Requested exchange does not list the symbol, returning empty or error","limit exceeds maximum of 1000, rejected with validation error","since timestamp in wrong format returns parse error","Exchange API rate limiting or downtime causes partial or failed fetch","Gaps in exchange data reported in gaps[] rather than interpolated"],"whenToPreferThis":"Use this endpoint when you need raw OHLCV candlestick data from a specific major exchange (Binance, Coinbase, Kraken, OKX, Bybit) for a crypto trading pair, especially when you need: transparent gap reporting rather than interpolation, clear flagging of partially formed candles, automatic multi-page aggregation for large limit requests, or consistent timestamp formatting in UTC milliseconds. Prefer this over generic market data APIs when exchange-specific candle fidelity and gap transparency matter, such as for backtesting, charting, or volume analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:32:12.764Z","isFirstParty":false,"canonicalSlug":"halowerk-marktwerk-candles-81bb506e"}