Candles endpoint now returns buy volume for Binance and Binance Futures

The /candles endpoint now returns one more number for Binance and Binance Futures: takerBuyVolume, the part of each candle’s volume that was bought with market orders.

With it, every candle tells you not only how much traded, but how that volume split between buyers and sellers. Nothing else in the response changed, so your existing code keeps working.

What’s new

Each Binance and Binance Futures candle now has a takerBuyVolume field next to volume:

curl -G https://v2.taapi.io/candles \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=1" \
  --data-urlencode "backtrack=1"

This is a real response, for the 20:00 UTC hour on 14 November 2026:

[
  {
    "open": 65727.61,
    "high": 65884.01,
    "low": 64510.01,
    "close": 64768.39,
    "volume": 1635.55075,
    "takerBuyVolume": 598.91894,
    "timestamp": 1794686400,
    "timestampHuman": "2026-11-14 20:00:00"
  }
]

What the number means

Every trade has a buyer and a seller. One of them was already waiting in the order book with a limit order. The other one, the taker, came in with a market order and took it. Binance records, for every candle, how much of the volume was bought by takers. That’s takerBuyVolume.

It’s in the same unit as volume: the base currency, so BTC for BTCUSDT. From the two numbers you get the full split:

• Buy volume = takerBuyVolume
• Sell volume = volume − takerBuyVolume
• Delta = buy volume − sell volume. Positive means buyers were more aggressive.

In the candle above, 1,636 BTC traded. Market buyers took 599 BTC and market sellers 1,037 BTC: only 37% of the volume was bought. Price fell about 1.5% that hour, and sellers clearly drove it.

The same hour on Binance Futures (exchange=binancefutures) shows 15,184 BTC traded and 6,085 BTC bought: 40% buying. Both markets agreed on who was in control.

Where it’s available

• Exchanges: Binance (binance) and Binance Futures (binancefutures), all symbols.
• Timeframes: all of them, 1m to 1w.
• History: we filled in the buy volume for past candles too, so you get it for the candles you already request, not only for new ones.
• Live candles: the current, still-forming candle includes it as well.

On other exchanges the field is left out, because they don’t publish this number. If you need an estimate there, the Volume Split indicator infers the split from the shape of the candle.

Don’t want to do the math yourself?

If you’d rather get buy volume, sell volume and their difference ready-made, use the new Volume Delta indicator. It’s built on this same data and also gives you the cumulative volume delta (CVD), through REST, bulk and WebSocket, in the same call as your other indicators. Our Volume Delta and CVD tutorial shows how traders use it.

What to do

Nothing, unless you want the new data. Responses for Binance and Binance Futures now carry one more field, and everything else is unchanged. If your code validates candle objects strictly against a fixed list of fields, allow takerBuyVolume.

The full field list is in the Candles documentation. If you have questions, contact us.