---
title: "Get Binance Candles"
method: GET
path: "/v2/binance/candles/{symbol}"
tags: ["binance"]
---

# Get Binance Candles

`GET /v2/binance/candles/{symbol}`

Fetch OHLCV candlestick data for a Binance trading pair.

Candle prices are derived from book ticker mid-prices (not trade prices).

**Backtesting crypto up/down markets:**
- Use `interval=15m` for 15-minute prediction markets
- Use `interval=1h` for 1-hour prediction markets
- Use `interval=4h` and `interval=1d` for longer timeframes

## Path parameters

- `symbol` 'BTCUSDT' | 'ETHUSDT' | 'SOLUSDT' | 'XRPUSDT', required — Supported Binance trading pairs for crypto up/down market backtesting.

## Query parameters

- `interval` '1s' | '1m' | '5m' | '15m' | '1h' | '4h' | '1d' — Candlestick intervals aligned with crypto up/down market timeframes. - 1s, 1m: high-resolution data from pre-aggregated tables - 5m, 15m, 1h, 4h, 1d: aggregated on-the-fly from 1m candles
- `start_time` integer, nullable — Unix timestamp (seconds) for range start
- `end_time` integer, nullable — Unix timestamp (seconds) for range end
- `limit` integer — Max candles to return

## Response `200`

Successful Response

- BinanceCandlesResponse — 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[], required — Array of candles, ordered by timestamp ASC
    - `timestamp` integer, required — Unix timestamp (seconds) at period start
    - `open` number, required — Opening mid-price in USDT
    - `high` number, required — Highest mid-price in USDT
    - `low` number, required — Lowest mid-price in USDT
    - `close` number, required — Closing mid-price in USDT
    - `tick_count` integer, required — Number of book ticker updates in this candle
    - `avg_spread` number, required — Average bid-ask spread over this candle

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/revisions/80a306fbdb39/schema)