Skip to main content
GET
Get Binance Candles
Fetch OHLCV candlestick data derived from Binance book ticker mid-prices. Supported intervals: 1s, 1m, 5m, 15m, 1h, 4h, 1d.
Requires Dev or Pro tier. This endpoint is not available on the Free tier.

Time Range Limits

Useful for backtesting crypto up/down prediction markets:
  • 15m for 15-minute markets
  • 1h for 1-hour markets
  • 4h and 1d for longer timeframes

Authorizations

x-api-key
string
header
required

Path Parameters

symbol
enum<string>
required

Trading pair

Available options:
BTCUSDT,
ETHUSDT,
SOLUSDT,
XRPUSDT

Query Parameters

interval
enum<string>
default:1m

Candle interval

Available options:
1s,
1m,
5m,
15m,
1h,
4h,
1d
start_time
integer | null

Unix timestamp (seconds) for range start

Required range: x >= 0
end_time
integer | null

Unix timestamp (seconds) for range end

Required range: x >= 0
limit
integer
default:500

Max candles to return

Required range: 1 <= x <= 1500

Response

Successful Response

OHLCV candlestick response for a Binance trading pair.

Intervals 1s and 1m are served from pre-aggregated materialized views. Larger intervals (5m, 15m, 1h, 4h, 1d) are aggregated on-the-fly from 1m data.

symbol
string
required

Trading pair (e.g. BTCUSDT)

interval
string
required

Candle interval (e.g. 15m, 1h)

candles
BinanceCandleData · object[]
required

Array of candles, ordered by timestamp ASC