Skip to main content
GET
/
v2
/
binance
/
candles
/
{symbol}
Get Binance Candles
curl --request GET \
  --url https://api.predexon.com/v2/binance/candles/{symbol} \
  --header 'x-api-key: <api-key>'
{
  "symbol": "<string>",
  "interval": "<string>",
  "candles": [
    {
      "timestamp": 123,
      "open": 123,
      "high": 123,
      "low": 123,
      "close": 123,
      "tick_count": 123,
      "avg_spread": 123
    }
  ]
}
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.
ConstraintValue
limit1–1,500 (default 500)

​
Time Range Limits

IntervalMax Range
1s1 hour
1m7 days
5m30 days
15m90 days
1h180 days
4h365 days
1d730 days
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