Volume Profile Functions

The volume_profile source carries a variable number of price-level buckets per bar — each bucket is [priceLow, priceHigh, buyVol, sellVol]. Because the bucket count changes from bar to bar, the source has no scalar properties; you can't read .buy / .sell off it directly. Instead, use these accessor functions to pull scalar timeseries out of the profile.

Open the source first, then pass it to any accessor:

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
var totalBuy  = vpBuy(vpa);
var totalSell = vpSell(vpa);
var poc       = vpPoc(vpa);

vpBuy

vpBuy(source: TimeSeries): number — total buy volume summed across all price-level buckets at the current bar.

Returns: number — total buy volume at this bar.

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries totalBuy = vpBuy(vpa);
plotLine(value=totalBuy, colors=["#26a69a"], width=2, label=["Total Buy"], desc=["Sum of buy volume per bar"]);

vpSell

vpSell(source: TimeSeries): number — total sell volume summed across all price-level buckets at the current bar.

Returns: number — total sell volume at this bar.

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries totalSell = vpSell(vpa);
plotLine(value=totalSell, colors=["#ef5350"], width=2, label=["Total Sell"], desc=["Sum of sell volume per bar"]);

vpDelta

vpDelta(source: TimeSeries): number — net buy/sell delta at the current bar (vpBuy − vpSell). Positive = buy dominant, negative = sell dominant.

Returns: number — buy minus sell volume at this bar.

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries delta = vpDelta(vpa);
plotBar(value=delta, colors=["#26a69a", "#ef5350"], label=["Delta"], desc=["Net buy/sell pressure"]);

vpTotal

vpTotal(source: TimeSeries): number — total volume (buy + sell) summed across all buckets at the current bar.

Returns: number — combined buy + sell volume at this bar.

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries total = vpTotal(vpa);
plotLine(value=total, colors=["#9e9e9e"], width=2, label=["Total"], desc=["Combined volume"]);

vpPoc

vpPoc(source: TimeSeries): number — Point of Control: the midprice of the bucket with the highest combined buy + sell volume at the current bar.

Returns: number — POC price (NaN if no buckets at this bar).

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries poc = vpPoc(vpa);
plotLine(value=poc, colors=["#ff9800"], width=2, label=["POC"], desc=["Point of Control"]);

vpPocVolume

vpPocVolume(source: TimeSeries): number — combined buy + sell volume at the POC bucket (the bucket with the highest combined volume).

Returns: number — volume at the POC bucket.

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries pocVol = vpPocVolume(vpa);

vpBucketCount

vpBucketCount(source: TimeSeries): number — number of price-level buckets present at the current bar.

Returns: number — count of price buckets at this bar.

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries depth = vpBucketCount(vpa);

vpPriceHigh

vpPriceHigh(source: TimeSeries): number — highest priceHigh across all buckets at the current bar (top of the volume-profile range).

Returns: number — highest price covered by the profile (NaN if empty).

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries top = vpPriceHigh(vpa);

vpPriceLow

vpPriceLow(source: TimeSeries): number — lowest priceLow across all buckets at the current bar (bottom of the volume-profile range).

Returns: number — lowest price covered by the profile (NaN if empty).

timeseries vpa = volume_profile(symbol=currentSymbol, exchange=currentExchange);
timeseries bottom = vpPriceLow(vpa);

Best Practices