# Trade Volume Index

Trade Volume Index is an indicator on [Vela](https://vela.luxalgo.com/chart), our next-generation charting platform, written in Pine Script®.

Plots the cumulative Trade Volume Index as a line colored by its live accumulation, distribution or neutral classification, with the minimum tick value defaulting to the instrument tick size and an optional intrabar granularity. Flags price extremes TVI fails to confirm, shades quiet accumulation or distribution in flat markets, and carries seven alerts.

- Indicator in the LuxAlgo Library, by LuxAlgo, published Jul 3, 2026.
- Access: free.
- Concepts: [Trade Volume Index](https://www.luxalgo.com/library/concept/trade-volume-index/) (primary)
- Open on Vela: https://vela.luxalgo.com/chart?pineScriptCodeId=ruoqe6aogih3ypbkalewtlof
- Page: https://www.luxalgo.com/library/indicator/trade-volume-index/

**Trade Volume Index** accumulates volume print by print, adding it when a price change clears the minimum tick value to the upside and subtracting when it clears it to the downside, the first faithful chart build of the [Trade Volume Index](https://www.luxalgo.com/library/concept/trade-volume-index/). Moves that stay inside the threshold keep the prior qualifying direction, so steady trading at one price keeps crediting the side that got it there. The line is colored by its live classification, with extreme checks and a flat-market read layered on top.

## How to Trade the Trade Volume Index?

- **Non-confirmation**: price takes out its 20-bar extreme but TVI cannot take out its own. Circles mark the bar when enabled, alerts fire regardless.
- **Confirmed Upside Breakout**: price and TVI make new highs together, qualifying the push with buy-side volume.
- **Quiet accumulation/distribution**: with price's range under the flat threshold, a rising TVI shades the pane bullish and a falling one bearish, the classic pre-markup and pre-markdown reads.

## Trade Volume Index Settings

- **Minimum Tick Value** (default 0): the move a print must clear to count as directional; 0 uses the instrument tick size, larger values latch the direction longer.
- **Granularity** (default Chart Bars): applies the rule to bar closes, or to intrabar closes via Lower Timeframe (Intrabars) to approximate the tick data TVI was designed for.
- **Lower Timeframe** (default 1): intrabar resolution for that mode; bars without coverage fall back to chart bars.
- **Extreme Lookback** (default 20): window defining new price and TVI extremes.
- **Flat Market Lookback** (default 20) and **Flat Market Range %** (default 2): window and maximum range, as a percent of the average close, for price to count as flat.
- Style: **Non-Confirmation Markers** (off) and **Quiet Accumulation/Distribution Highlight** (on).

## Frequently Asked Questions

### How is the Trade Volume Index different from On-Balance Volume?

[On-Balance Volume](https://www.luxalgo.com/library/indicator/on-balance-volume/) commits a bar's whole volume by close-versus-prior-close, so it goes quiet when price barely changes between prints. TVI's threshold-with-carryover rule keeps classifying those static stretches, which is why the design targets intraday and tick-style data.

### Does the level of the TVI line mean anything?

No. The seed value is arbitrary; information lives in slope and divergence alone. That is also why this build colors the line by its current classification rather than by its value.

### What happens on symbols without volume?

The script stops with an explicit error, since a volume-driven running total is undefined without volume data. Where volume exists, the intrabar granularity brings the rule closer to its tick-data origins.

## Related indicators

- [Oscillator Matrix](https://www.luxalgo.com/library/indicator/luxalgo-oscillator-matrix/) (Money Flow Index): markdown at https://www.luxalgo.com/library/indicator/luxalgo-oscillator-matrix.md
- [LuxAlgo - Screener (OSC)](https://www.luxalgo.com/library/indicator/luxalgo-screener-osc/) (Money Flow Index): markdown at https://www.luxalgo.com/library/indicator/luxalgo-screener-osc.md
- [Delta ZigZag](https://www.luxalgo.com/library/indicator/delta-zigzag/) (Weis Wave Volume): markdown at https://www.luxalgo.com/library/indicator/delta-zigzag.md
- [Price Zone Oscillator](https://www.luxalgo.com/library/indicator/price-zone-oscillator/) (Volume & Order Flow): markdown at https://www.luxalgo.com/library/indicator/price-zone-oscillator.md
- [OBV Divergence](https://www.luxalgo.com/library/indicator/obv-divergence/) (Volume & Order Flow): markdown at https://www.luxalgo.com/library/indicator/obv-divergence.md
- [Smart Money Index](https://www.luxalgo.com/library/indicator/smart-money-index/) (Volume & Order Flow): markdown at https://www.luxalgo.com/library/indicator/smart-money-index.md
- [Volume Flow Indicator](https://www.luxalgo.com/library/indicator/volume-flow-indicator/) (Volume & Order Flow): markdown at https://www.luxalgo.com/library/indicator/volume-flow-indicator.md
- [Demand Index](https://www.luxalgo.com/library/indicator/demand-index/) (Volume & Order Flow): markdown at https://www.luxalgo.com/library/indicator/demand-index.md

---

Source: https://www.luxalgo.com/library/indicator/trade-volume-index/ (LuxAlgo Library). Free to use with attribution: https://www.luxalgo.com/library/license/
