The Cumulative Volume Index Calculator computes the cumulative difference between advancing and declining volume to gauge market breadth trends and flags divergences.
Report an issue
Spotted a wrong result, broken field, or typo? Tell us below and we’ll fix it fast.
About the Cumulative Volume Index Calculator
The Cumulative Volume Index (CVI) is a market breadth indicator that accumulates the difference between advancing volume and declining volume. Advancing volume is the total number of shares traded in stocks that closed up for the session. Declining volume is the total number of shares traded in stocks that closed down. The CVI adds the net difference each period, creating a long-running series.
Why does this matter? Price alone can rise on light participation. The CVI shows whether rising prices have “depth” behind them. When the CVI climbs with the market, more volume supports the uptrend. When the CVI trends down while prices rise, it warns that participation may be thinning. This calculator turns that idea into repeatable numbers, so you can test scenarios and make decisions with clearer assumptions.
It differs from On-Balance Volume (OBV), which uses a single security’s price change to add or subtract that security’s volume. The CVI is exchange- or index-wide. It focuses on how total market volume splits between winners and losers, which is a broader measure of participation.
The Mechanics Behind Cumulative Volume Index
At its core, the CVI is a running sum of daily volume breadth. Each period, you compare how much volume traded in advancing issues versus declining issues, then add the net to yesterday’s total. The line rises when advancing volume dominates and falls when declining volume dominates.
- Define inputs per period: Advancing Volume (AV) and Declining Volume (DV) across the chosen market universe.
- Calculate the daily breadth volume difference: Net Volume Breadth = AV − DV.
- Cumulate: Today’s CVI = Yesterday’s CVI + Net Volume Breadth; choose a starting value (often 0 or 100).
- Interpret trend: Rising CVI suggests broad buying interest; falling CVI suggests broad selling pressure.
- Watch divergences: A market making new highs while CVI stalls or falls can signal weakening internals.
- Optional smoothing: Apply a moving average to reduce noise and reveal the underlying trend.
Because it accumulates day after day, the CVI’s absolute value is less important than its direction, slope, and relationship to price. Most analysts compare the CVI to a benchmark index to spot confirmations and warnings. The Calculator packages these mechanics into an easy workflow.
Cumulative Volume Index Formulas & Derivations
The standard CVI uses a simple cumulative approach. Some traders also use a percentage version to normalize by total volume, which helps when comparing across markets or very long histories. Smoothing methods like SMA or EMA are optional but common for trend analysis.
- Daily net breadth: D_t = AV_t − DV_t
- Cumulative Volume Index: CVI_t = CVI_{t−1} + D_t, with CVI_0 set by the user (e.g., 0)
- Percentage version: pD_t = (AV_t − DV_t) / (AV_t + DV_t), then pCVI_t = pCVI_{t−1} + pD_t
- Simple Moving Average: SMA_n(CVI)_t = (1/n) × Σ_{i=0}^{n−1} CVI_{t−i}
- Exponential Moving Average: EMA_t = α × CVI_t + (1 − α) × EMA_{t−1}, with α = 2 / (n + 1)
- Rescaling for display (optional): scaled_CVI_t = 100 × (CVI_t − min) / (max − min) over a chosen lookback
The raw cumulative method emphasizes long swings in breadth. The percentage variant makes readings comparable when total volume changes structurally, such as across decades or between exchanges. Use smoothing if your focus is medium-term trend rather than day-to-day fluctuations.
Inputs and Assumptions for Cumulative Volume Index
The Calculator needs a few core inputs. You can paste data or connect a feed, then choose how you want results displayed. These inputs anchor your methodology, so keep notes on the assumptions behind them.
- Advancing Volume series (AV): Total shares traded in advancing issues per period.
- Declining Volume series (DV): Total shares traded in declining issues per period.
- Starting value: Initial CVI level (commonly 0 or 100 for readability).
- Frequency: Daily or weekly data, depending on your workflow.
- Smoothing window (optional): SMA or EMA length (e.g., 10, 20, or 50 periods).
- Benchmark price series (optional): An index or ETF to compare with the CVI line.
Volumes should be non-negative integers (or floats if sourced as thousands/millions). If AV + DV equals zero for a period, the percentage version is undefined for that day. Missing days, half days, and holidays can cause jumps in the slope if not handled consistently. The CVI is not typically adjusted for corporate actions, but changes in index membership or exchange coverage will affect interpretation.
Step-by-Step: Use the Cumulative Volume Index Calculator
Here’s a concise overview before we dive into the key points:
- Open the Calculator and select your data frequency (daily or weekly).
- Load or paste the Advancing Volume and Declining Volume columns with matching dates.
- Choose a starting value (0 is standard) and select raw or percentage mode.
- Optionally set a smoothing method and window (e.g., 20-day SMA or EMA).
- Add an optional benchmark series to display price and CVI together.
- Click Calculate to generate the CVI line and review the chart and statistics.
These points provide quick orientation—use them alongside the full explanations in this page.
Example Scenarios
Scenario 1: A broad-based upswing. Over five sessions, AV and DV are: Day 1 (1.2B vs 0.8B), Day 2 (1.1B vs 0.9B), Day 3 (1.3B vs 0.7B), Day 4 (1.0B vs 1.0B), Day 5 (1.4B vs 0.6B). Daily net breadth is +0.4B, +0.2B, +0.6B, 0, and +0.8B shares. Starting at 0, the CVI rises to +2.0B by Day 5. The index price is up only 0.6% in the same period. The CVI’s steady climb shows strong participation despite a modest price gain, supporting the view that the uptrend has depth. What this means: momentum likely has room to extend if conditions hold.
Scenario 2: A divergence near a high. Over six sessions, AV and DV are mixed: Day 1 (1.0B vs 1.2B), Day 2 (0.9B vs 1.1B), Day 3 (1.3B vs 1.0B), Day 4 (1.1B vs 1.2B), Day 5 (1.2B vs 1.3B), Day 6 (1.0B vs 0.9B). Net breadth is −0.2B, −0.2B, +0.3B, −0.1B, −0.1B, +0.1B. The CVI starts at 0 and ends at −0.2B even as the index posts a new closing high on Day 6. Price made progress, but the CVI failed to confirm with a higher high. What this means: risk of a pullback is rising unless breadth improves quickly.
Assumptions, Caveats & Edge Cases
The CVI is only as good as the definitions and data behind it. Make your assumptions explicit and stay consistent across tests. Here are common caveats and edge cases to watch for during analysis and breakdowns.
- Universe definition: Decide which exchange or index membership you use; changes in membership can shift trends.
- Half days and holidays: Lower volume can distort percentage versions; label such sessions clearly.
- Data gaps: Missing AV or DV values break continuity; fill or exclude with a clear rule.
- Corporate actions: While volume typically needs no split adjustment, corporate events can change issue counts.
- Cross-venue trading: Off-exchange prints may not be captured uniformly across feeds, affecting totals.
Always cross-check the CVI against price and other breadth indicators. A single indicator can mislead in unusual conditions, such as extreme news shocks, rebalancing days, or index composition changes. Combining the CVI with measures like the Advance-Decline Line and new highs/new lows adds context.
Disclaimer: This tool is for educational estimates. Consider professional advice for decisions.
Units Reference
Units ground your inputs and outputs. Advancing and declining volume may be reported in raw shares, thousands, or millions. The raw CVI uses the same unit as the input volume. The percentage CVI is dimensionless, which helps when comparing different markets.
| Data item | Typical unit | Notes |
|---|---|---|
| Advancing Volume (AV) | Shares (or thousands/millions) | Ensure AV and DV use the same scale. |
| Declining Volume (DV) | Shares (or thousands/millions) | Non-negative; align dates with AV. |
| CVI (raw) | Shares (or thousands/millions) | Same base unit as AV and DV. |
| Percentage CVI | Unitless | Based on (AV − DV) / (AV + DV). |
| SMA / EMA | Same as CVI mode | Raw CVI MAs in shares; percentage CVI MAs unitless. |
When you switch data providers, confirm whether volumes are in raw shares or scaled. If you mix units, the CVI will be off by a constant factor and comparisons will break. The table helps you align inputs before running calculations.
Tips If Results Look Off
If the chart or numbers do not match your expectations, check for data alignment and scaling first. Most issues come from mismatched dates or inconsistent units between AV and DV. Then confirm your starting value and smoothing settings.
- Verify dates: Every AV row must match a DV row.
- Check units: Do not mix raw shares with thousands.
- Confirm starting value: Re-run with 0 if unsure.
- Spot outliers: Inspect abnormal spikes in AV or DV.
- Try the percentage mode: It can stabilize comparisons.
After fixing the basics, compare your output with a known reference, like a published breadth chart for the same market. Small differences are normal across data vendors, but large gaps often signal a feed or scaling issue.
FAQ about Cumulative Volume Index Calculator
How is the CVI different from the Advance-Decline Line?
The Advance-Decline Line counts the number of advancing minus declining issues, while the CVI uses advancing volume minus declining volume. The A/D Line measures breadth by issue count; the CVI measures breadth by traded volume.
Should I start the CVI at zero or another number?
Zero is standard and makes comparisons straightforward. Some analysts pick 100 or 1,000 to improve chart readability. The starting value does not affect slope or signals, only the baseline level.
Is the percentage version better than the raw CVI?
Neither is “better” in all cases. The raw CVI tracks absolute net volume, which highlights big participation shifts. The percentage version normalizes by total volume, helping compare across regimes or markets with different volume scales.
Can I use weekly data instead of daily?
Yes. Weekly data reduces noise and emphasizes medium-term trends. Be consistent when comparing with price: use weekly price bars or a weekly benchmark to avoid mismatched interpretations.
Key Terms in Cumulative Volume Index
Advancing Volume (AV)
Total shares traded in all securities that finish the period with a price gain.
Declining Volume (DV)
Total shares traded in all securities that finish the period with a price loss.
Cumulative Volume Index (CVI)
A running total of advancing volume minus declining volume, used to gauge market participation.
Net Volume Breadth
The per-period difference AV − DV, which is added to the prior CVI value.
Percentage CVI
A normalized version that adds (AV − DV) / (AV + DV) each period, making results unitless.
Moving Average (SMA/EMA)
Smoothing methods applied to the CVI to reduce noise and highlight the main trend.
Divergence
When price trends one way but the CVI fails to confirm, hinting at a potential reversal or pause.
Market Breadth
A collection of indicators that measure how widely a market move is supported across issues or volume.
Sources & Further Reading
Here’s a concise overview before we dive into the key points:
- StockCharts ChartSchool: Advance-Decline Volume Line
- StockCharts ChartSchool: Market Breadth Indicators Overview
- StockCharts ChartSchool: Negative and Positive Volume Index
- Investopedia: On-Balance Volume (OBV) Explained
- MarketVolume: Cumulative Volume Index (CVI)
These points provide quick orientation—use them alongside the full explanations in this page.