Volume Split
Category: Price & market data · Updated November 2026
The TAAPI.IO Volume Split API splits each candle's volume into buying and selling. On Binance and Binance Futures it uses the exchange's real taker volume: the volume bought and sold with market orders. On other markets, including US stocks, it estimates the split from where the candle closed inside its high-low range: a close at the high counts as all buying, a close at the low as all selling. The method field says which one you got. Both can be smoothed over several candles with smaPeriod or sumPeriod.
Real volume on Binance, an estimate elsewhere. The estimate comes from the candle's shape, not from the trades on the exchange, so it can differ a lot from the real buy and sell volume. Read how close it gets before using it as buy/sell pressure. For volume delta and cumulative volume delta (CVD) on Binance, see Volume Delta.
| Spec | Value |
|---|---|
| Endpoint | GET https://v2.taapi.io/indicator/volumesplit |
| Outputs | valueTotal, valueBuy, valueSell, percentBuy, percentSell, method |
| Markets | Binance and Binance Futures (real taker volume); Bybit, Gate.io, Kraken and US stocks (estimate) |
| Timeframes | 1m to 1w |
| Delivery | REST, bulk and WebSocket |
Get Volume Split with one API call
This request returns Volume Split for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.
curl -G https://v2.taapi.io/indicator/volumesplit \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "exchange=binance" \ --data-urlencode "symbol=BTCUSDT" \ --data-urlencode "timeframe=1h"
import requests
resp = requests.get(
'https://v2.taapi.io/indicator/volumesplit',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h'},
)
print(resp.json())const params = new URLSearchParams({"exchange": "binance", "symbol": "BTCUSDT", "timeframe": "1h"});
const res = await fetch(`https://v2.taapi.io/indicator/volumesplit?${params}`, {
headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
console.log(await res.json());Volume Split API response
Live output from Binance's taker volume for the BTCUSDT 1-hour candle that opened at 09:00 UTC on 13 November 2026, 19 minutes in. Sellers took about 59% of the volume. With method=estimate the same candle came out at 82% buying, because price sat near the top of its range so far: a clear case of the estimate pointing the wrong way.
{
"valueTotal": [460.8689600000001],
"valueBuy": [190.58146],
"valueSell": [270.2875000000001],
"percentBuy": [41.35263524798892],
"percentSell": [58.64736475201108],
"method": "taker",
"timestamp": [1794560400]
}| Field | Type | Description |
|---|---|---|
valueTotal | number[] | Total volume of the candle, in the base asset (e.g. BTC) or shares. |
valueBuy | number[] | Buy volume: the exchange's taker buy volume (method taker), or valueTotal × (close − low) ÷ (high − low) (method estimate). |
valueSell | number[] | Sell volume: valueTotal − valueBuy. |
percentBuy | number[] | valueBuy as a percentage of valueTotal. 50 when the candle has no volume, or no range with the estimate. |
percentSell | number[] | valueSell as a percentage of valueTotal. Always 100 − percentBuy. |
method | string | taker (real taker volume) or estimate (close location). One value for the whole response. |
timestamp | integer[] | Unix time of each candle, in seconds. |
With smaPeriod the fields are smaTotal, smaBuy, smaSell, smaPercentBuy and smaPercentSell; with sumPeriod they start with sum instead. The percentages are volume-weighted: buy volume ÷ total volume over the window, so busy candles count for more than quiet ones.
Volume Split API parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
exchange | string | Yes | — | binance, binancefutures, bybit, gateio, kraken or stocks |
symbol | string | Yes | — | Pair or ticker, e.g. BTCUSDT or AAPL |
method | string | No | auto | auto: real taker volume when every candle has it (Binance, Binance Futures), otherwise the estimate for all candles. taker: real taker volume only, an error on other exchanges. estimate: always the close-location estimate. |
timeframe | string | Yes | — | 1m 5m 15m 1h 4h 1d 1w |
smaPeriod | integer | No | — | Average the split over this many candles. Returns the sma… fields instead of the per-candle ones. Takes priority over sumPeriod. |
sumPeriod | integer | No | — | Add up the split over this many candles, e.g. 24 on 1h candles for the last day. Returns the sum… fields. |
results | integer | No | 1 | Number of values to return, or max |
backtrack | integer | No | 0 | Candles to skip from the most recent |
What is Volume Split?
Candles only tell you how much traded, not who was buying and who was selling. Binance and Binance Futures add one more number to each candle: the volume bought by takers, the side that crossed the spread with a market order. Volume Split uses it directly when it is there (method=taker). Everywhere else it fills the gap with a simple assumption: the closer a candle closes to its high, the more of its volume was buying. It is the same "close location" idea used inside Accumulation/Distribution and Chaikin Money Flow, applied to one candle at a time.
Volume Split formula
| Output | Calculation |
|---|---|
Buy share, taker | taker buy volume ÷ valueTotal |
Buy share, estimate | (close − low) ÷ (high − low), or ½ if high = low |
valueBuy | valueTotal × buy share |
valueSell | valueTotal − valueBuy |
percentBuy | buy share × 100 |
sumPercentBuy / smaPercentBuy | sum of valueBuy ÷ sum of valueTotal × 100 over the window |
Example of the estimate: a 1-hour candle with low 100, high 110, close 108 and volume 500. The close is 80% of the way up the range, so valueBuy = 400, valueSell = 100 and percentBuy = 80.
How close is the estimate to real buy and sell volume?
This applies to method=estimate. Binance reports how much of each candle's volume came from buyers lifting the ask (taker buy volume), so we compared that with the estimate on 1,000 Binance candles each for BTCUSDT, ETHUSDT and SOLUSDT on 15m, 1h, 4h and 1d candles (November 2026).
| Measure | Result |
|---|---|
| Picks the same side as real volume (more buying or more selling) | 59–68% of candles |
Average gap between percentBuy and the real buy share | 21–27 percentage points |
| Real buy share on 1h candles (middle 90%) | about 37% to 66% |
Estimated percentBuy | anywhere from 0 to 100 |
In short: real markets are almost never 90% sellers in an hour, but the estimate says so whenever a candle closes near its low. Treat percentBuy as "where did price finish inside the candle, weighted by volume", not as a count of buy orders. The estimate gets more useful when you add it up over many candles. On Binance and Binance Futures, the default method=auto returns the real taker volume instead.
How to read Volume Split in your code
| Signal | Meaning | Condition |
|---|---|---|
| Closing strength over a period | Volume has been finishing near the highs: steady buying pressure | sumPercentBuy above about 55 with sumPeriod of 20 or more |
| Closing weakness over a period | Volume has been finishing near the lows: steady selling pressure | sumPercentBuy below about 45 |
| Strong close on high volume | A breakout candle that held its gains | percentBuy above 70 and valueTotal well above smaTotal |
| Divergence | Price makes a new high but closing strength fades | Price higher than N candles ago while sumPercentBuy is lower |
Limitations: Outside Binance, Volume Split is estimated from the candle (open, high, low, close and volume), not from trades, so a single candle's percentBuy says little about real buyers and sellers (see accuracy), and long wicks and gaps distort it. Taker volume shows who used market orders, not who will win: resting limit orders can absorb them. The candle still forming changes until it closes. It describes past candles and does not predict the next one. Nothing on this page is financial advice.
Read buying pressure over the last day
One candle is noisy, so add up the split over 24 closed hourly candles with sumPeriod=24. backtrack=1 skips the candle still forming.
curl -G https://v2.taapi.io/indicator/volumesplit \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "exchange=binance" \ --data-urlencode "symbol=BTCUSDT" \ --data-urlencode "timeframe=1h" \ --data-urlencode "sumPeriod=24" \ --data-urlencode "backtrack=1"
import requests
resp = requests.get(
'https://v2.taapi.io/indicator/volumesplit',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h',
'sumPeriod': 24, 'backtrack': 1},
)
data = resp.json()
share = data['sumPercentBuy'][-1]
print(f"Last 24 closed hours: {share:.1f}% of volume closed on the buy side")
if share > 55:
print('Closing strength: volume has been finishing near the highs')
elif share < 45:
print('Closing weakness: volume has been finishing near the lows')
else:
print('Balanced')Get historical Volume Split values
Add results to return a series for backtesting or charting. The last element is the most recent candle.
curl -G https://v2.taapi.io/indicator/volumesplit \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "exchange=binance" \ --data-urlencode "symbol=BTCUSDT" \ --data-urlencode "timeframe=1h" \ --data-urlencode "results=100"
Get Volume Split for multiple symbols
Combine Volume Split with other indicators in one request. Each exchange, symbol and timeframe combination is one construct: Basic allows 1 per request, Pro 3 and Expert 10.
curl -X POST https://v2.taapi.io/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"constructs": [
{
"id": "btc_1h",
"exchange": "binance",
"symbol": "BTCUSDT",
"timeframe": "1h",
"indicators": [
{
"id": "volumesplit",
"indicator": "volumesplit"
},
{
"id": "rsi",
"indicator": "rsi"
}
]
}
]
}'Stream Volume Split in real time
Subscribe over WebSocket to receive new values every 5 seconds while the candle is forming. Streaming supports 1m, 5m, 15m and 1h, and uses interval where REST uses timeframe.
{
"type": "subscribe",
"id": "volumesplit",
"exchange": "binance",
"symbol": "BTCUSDT",
"interval": "1m",
"indicator": "volumesplit"
}Volume Split API FAQ
What does the Volume Split API return?
Per candle: valueTotal, valueBuy, valueSell, percentBuy and percentSell, plus timestamp. With smaPeriod or sumPeriod you get the same five values averaged or summed over the window.
Is the latest Volume Split value final?
No. The newest value belongs to the candle still forming and can change until it closes. Add backtrack=1 to read the last closed candle.
Is this real buy and sell volume?
On Binance and Binance Futures, yes: it is the exchange's taker volume, and method is taker. On other exchanges and US stocks it is estimated from where each candle closed inside its range, which can be far from the real split. See how close it gets.
Can I get Volume Split for US stocks?
Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.
Related indicators
See the full list of indicators, or start for free.