{"uid":"cap_8hmeslweQn_QWxU2BCOB8","slug":"crypto-market-data-historical-klines-binance-candlesticks-590a19b7","name":"Crypto Market Data – Historical Klines (Binance Candlesticks)","description":"A crypto market data agent that exposes live symbols, market metadata, and historical Binance candlesticks.","url":"https://crypto-market-data.up.railway.app/historical-klines","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Z0-9]+$","examples":["BTCUSDT"],"description":"Trading symbol, e.g. BTCUSDT."},"to_time":{"type":"string","examples":["2024-01-02 00:00"],"description":"End of the time range, format: %Y-%m-%d %H:%M"},"interval":{"enum":["1m","3m","5m","15m","30m","1h","2h","4h","6h","8h","12h","1d","3d","1w","1M"],"type":"string","title":"KlineInterval","default":"1h","description":"Candlestick interval"},"from_time":{"type":"string","examples":["2024-01-01 00:00"],"description":"Start of the time range, format: %Y-%m-%d %H:%M"}}},"responseSchema":{"type":"json","example":{"klines":[{"volume":125.5,"low_price":41800,"open_time":"2024-01-01T00:00:00","close_time":"2024-01-01T01:00:00","high_price":42500,"open_price":42000,"close_price":42200,"amount_trades":1250,"quote_asset_volume":5290000,"taker_buy_base_volume":60.3,"taker_buy_quote_volume":2541800}],"symbol":"BTCUSDT","interval":"1h"}},"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_HrMT4QXr-Mfc4oJrjaLYX","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 historical OHLCV candlestick (kline) data for a given crypto trading pair from Binance over a specified time range and interval.","exampleAgentPrompt":"Can you pull the 1-hour Binance candlesticks for BTCUSDT from January 1 2024 00:00 to January 2 2024 00:00 so I can see the open, high, low, close, and volume for each candle?","exampleUseCases":[{"title":"Backtesting a trading strategy","prompt":"Fetch 4-hour OHLCV candles for ETHUSDT from March 1 2024 00:00 to March 31 2024 00:00 so I can run a moving average crossover backtest."},{"title":"Identifying price peaks during a rally","prompt":"What were the hourly high and low prices for SOLUSDT between November 1 2024 00:00 and November 7 2024 00:00? I want to see how the rally played out candle by candle."},{"title":"Daily close price charting","prompt":"Give me the daily candlesticks for BNBUSDT from January 1 2024 00:00 to June 30 2024 00:00 — I need the open, close, high, and low for each day to build a chart."}],"resultDescription":"Returns a JSON object containing the requested symbol, the interval used, and an array of kline objects each with open_time, close_time, open_price, high_price, low_price, close_price, volume, quote_asset_volume, amount_trades, taker_buy_base_volume, and taker_buy_quote_volume — covering the full requested time window at the specified granularity.","failureModes":["Invalid symbol (e.g. lowercase or non-existent pair) returns an error or empty klines array","Malformed from_time or to_time (wrong format, not '%Y-%m-%d %H:%M') causes a parsing error","Requesting a very large time range at a fine interval (e.g. 1m over months) may exceed Binance's data limits or return truncated results","Symbol not listed on Binance returns empty or error response","Network or upstream Binance API outage returns a 5xx error from the service"],"whenToPreferThis":"Choose this endpoint when you need structured historical OHLCV candlestick data from Binance for a specific trading pair and date range — especially for backtesting, charting, or quantitative analysis. It is ideal when you need trade volume and taker-side buy volumes in addition to price. Prefer over generic crypto price APIs when you need Binance-sourced data with fine-grained interval control from 1-minute to monthly candles.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:32:50.450Z","isFirstParty":false}