QuanTAlib/lib/volatility/vov/Vov.md

VOV: Volatility of Volatility

Property	Value
Category	Volatility
Inputs	OHLCV bar (TBar)
Parameters	volatilityPeriod (default 20), vovPeriod (default 10)
Outputs	Single series (Vov)
Output range	\geq 0
Warmup	volatilityPeriod + vovPeriod - 1 bars

TL;DR

• Volatility of Volatility (VOV) measures the standard deviation of volatility itself, quantifying how much volatility fluctuates over time.
• Parameterized by volatilityperiod (default 20), vovperiod (default 10).
• Output range: \geq 0.
• Requires volatilityPeriod + vovPeriod - 1 bars of warmup before first valid output (IsHot = true).
• Validated against TA-Lib, Skender, and Tulip reference implementations where available.

"When markets become uncertain about their own uncertainty, that's when things get interesting."

Volatility of Volatility (VOV) measures the standard deviation of volatility itself, quantifying how much volatility fluctuates over time. While standard volatility tells you how much prices move, VOV tells you how stable or unstable that movement pattern is. High VOV indicates volatility is erratic and unpredictable; low VOV suggests volatility is relatively stable and consistent.

Historical Context

The concept of "vol of vol" emerged from options pricing and derivatives trading, where understanding the stability of volatility became crucial for pricing exotic options and managing portfolio risk. The Heston stochastic volatility model (1993) introduced a dedicated parameter (σ, often called "vol of vol") to capture this phenomenon, recognizing that volatility itself follows a random process.

In practice, traders noticed that implied volatility surfaces exhibit their own dynamics—sometimes stable, sometimes wildly fluctuating. The 2008 financial crisis and subsequent "flash crashes" demonstrated that periods of extreme VOV correlate with market stress and liquidity crises. When volatility becomes volatile, hedging becomes difficult and option pricing models break down.

This implementation uses a straightforward approach: compute rolling standard deviation (inner volatility), then compute the standard deviation of those values (outer VOV). Simple, interpretable, and effective for detecting volatility regime changes.

Architecture & Physics

1. Inner Volatility Calculation

For each bar, compute the population standard deviation of prices over the volatility period:

\sigma_{t}^{inner} = \sqrt{\frac{1}{n}\sum_{i=0}^{n-1}(P_{t-i} - \bar{P})^2}

where:

• P_t = Price (close) at time t
• n = Volatility period (default 20)
• \bar{P} = Mean price over the window

Using the computationally efficient form:

\sigma = \sqrt{E[X^2] - E[X]^2} = \sqrt{\frac{\sum x^2}{n} - \left(\frac{\sum x}{n}\right)^2}

2. Outer VOV Calculation

Apply the same standard deviation formula to the series of inner volatilities:

VOV_t = \sqrt{\frac{1}{m}\sum_{j=0}^{m-1}(\sigma_{t-j}^{inner} - \bar{\sigma})^2}

where:

• \sigma^{inner} = Inner volatility values
• m = VOV period (default 10)
• \bar{\sigma} = Mean of inner volatilities over the window

3. Population vs Sample Standard Deviation

This implementation uses population standard deviation (dividing by n, not n-1). For rolling window calculations with consistent period sizes, population stddev is appropriate and avoids the Bessel's correction bias that's designed for estimating population parameters from small samples.

Mathematical Foundation

Nested Standard Deviation

The core formula is simply:

VOV = StdDev(StdDev(Price, volatilityPeriod), vovPeriod)

Efficient Streaming Computation

For O(1) updates, maintain running sums:

Inner volatility buffer:

• priceSum = \sum P_i
• priceSumSq = \sum P_i^2

Outer VOV buffer:

• volSum = \sum \sigma_i
• volSumSq = \sum \sigma_i^2

Update formulas when adding new value x and removing old value x_{old}:

sum_{new} = sum_{old} + x - x_{old}

sumSq_{new} = sumSq_{old} + x^2 - x_{old}^2

Example Calculation

Consider volatilityPeriod=2, vovPeriod=2, prices: [100, 102, 98, 104]

Inner stddevs:

• Bar 1: StdDev([100, 102]) = \sqrt{(10202) - (101)^2} = \sqrt{1} = 1
• Bar 2: StdDev([102, 98]) = \sqrt{(10004) - (100)^2} = \sqrt{4} = 2
• Bar 3: StdDev([98, 104]) = \sqrt{(10210) - (101)^2} = \sqrt{9} = 3

Outer VOV:

• Bar 2: StdDev([1, 2]) = \sqrt{(2.5) - (1.5)^2} = \sqrt{0.25} = 0.5
• Bar 3: StdDev([2, 3]) = \sqrt{(6.5) - (2.5)^2} = \sqrt{0.25} = 0.5

Properties

1. Non-negativity: VOV ≥ 0 always (standard deviation is non-negative)
2. Zero when constant: If volatility doesn't change, VOV = 0
3. Scale independence: VOV is in the same units as volatility (price units)
4. Warmup requirement: Needs (volatilityPeriod + vovPeriod - 1) bars before valid output

Performance Profile

Operation Count (Streaming Mode, Scalar)

Per-bar operations:

Operation	Count	Cost (cycles)	Subtotal
ADD/SUB	8	1	8
MUL	6	3	18
DIV	4	15	60
SQRT	2	15	30
Ring buffer ops	4	2	8
Total	—	—	~124 cycles

O(1) complexity per bar—no iteration over window required.

Batch Mode (512 values, SIMD/FMA)

Operation	Scalar Ops	SIMD Ops (AVX2)	Speedup
Arithmetic	4096	512	8×
SQRT	1024	128	8×

The nested nature limits SIMD benefit for streaming, but batch mode can vectorize the inner stddev calculation significantly.

Memory Profile

• Per instance: ~200 bytes base + ring buffers
• Price buffer: volatilityPeriod × 8 bytes
• Volatility buffer: vovPeriod × 8 bytes
• Backup arrays: 2 × max(volatilityPeriod, vovPeriod) × 8 bytes for bar correction
• Default (20, 10): ~480 bytes per instance
• 100 instances: ~47 KB

Quality Metrics

Metric	Score	Notes
Accuracy	10/10	Exact calculation, no approximation
Timeliness	6/10	Dual-period lag inherent
Smoothness	7/10	Outer stddev provides smoothing
Interpretability	8/10	Clear meaning: volatility instability
Regime Detection	9/10	Excellent at detecting volatility transitions

Validation

Library	Status	Notes
TA-Lib	N/A	Not implemented
Skender	N/A	Not implemented
Tulip	N/A	Not implemented
OoplesFinance	N/A	Not implemented
PineScript	✅	Matches vov.pine reference
Self-consistency	✅	Streaming = Batch = Span modes match

Common Pitfalls

1. Warmup period confusion: VOV requires (volatilityPeriod + vovPeriod - 1) bars before producing valid output. Default (20, 10) needs 29 bars. Early values during warmup may be misleading.

2. Interpretation: Low VOV doesn't mean low volatility—it means volatility is stable (could be stably high). High VOV means volatility is unpredictable, regardless of its absolute level.

3. Parameter selection:

   • Shorter volatilityPeriod captures faster price dynamics but noisier inner vol
   • Shorter vovPeriod reacts faster to vol changes but noisier VOV
   • Common defaults: (20, 10) for daily data, (60, 20) for intraday

4. Scale awareness: VOV is in price units (like standard deviation). A VOV of 0.5 on a $100 stock is very different from VOV of 0.5 on a $10 stock. Consider normalizing by price or using percentage returns.

5. Regime lag: Due to the nested calculation, VOV inherently lags regime changes. By the time VOV spikes, the volatility shift has already begun.

6. Memory footprint: With two ring buffers plus backup arrays, VOV uses more memory than simpler indicators. For many simultaneous instances, consider the cumulative impact.

Trading Applications

Volatility Regime Detection

Track VOV to identify when volatility is transitioning:

If VOV rising from low base: Volatility regime change underway
If VOV falling toward zero: Volatility stabilizing
If VOV persistently high: Unstable market conditions

Options Trading

VOV correlates with the value of volatility derivatives:

High VOV: Straddles/strangles more valuable (vol could move either way)
Low VOV: Stable vol environment, directional bets may be safer

Position Sizing

Adjust exposure based on volatility predictability:

Position size = Base size × (Target VOV / Actual VOV)
Higher VOV → smaller positions (unpredictable conditions)

Risk Management

Use VOV as an early warning signal:

If VOV > 2 × average: Consider hedging
If VOV crosses threshold: Reduce leverage

Mean Reversion Strategies

Volatility tends to mean-revert; VOV helps time entries:

High VOV + High Vol: Wait for VOV to decline before selling vol
Low VOV + Low Vol: Vol likely to rise; prepare for expansion

Relationship to Other Indicators

Indicator	Relationship to VOV
ATR	ATR is level; VOV measures ATR stability
Bollinger Bandwidth	Bandwidth measures vol level; VOV measures bandwidth stability
VIX/VVIX	VVIX is the market's implied VOV; this is realized VOV
Heston σ	Heston vol-of-vol parameter; VOV is the realized equivalent
RVI	RVI measures vol direction; VOV measures vol instability
Standard Deviation	VOV is StdDev of StdDev

Implementation Notes

State Management

The indicator maintains four running sums (price sum, price sum-squared, vol sum, vol sum-squared) plus two ring buffers. For bar correction (isNew=false), backup arrays store previous buffer states.

NaN/Infinity Handling

Invalid inputs are replaced with the last valid price to prevent corruption of running sums. This ensures continuous operation even with data gaps.

Numerical Stability

The formula \sqrt{E[X^2] - E[X]^2} can produce small negative values due to floating-point errors when variance is near zero. The implementation guards against this by returning 0 when the computed variance is negative.

References

• Heston, S. L. (1993). "A Closed-Form Solution for Options with Stochastic Volatility with Applications to Bond and Currency Options." Review of Financial Studies, 6(2), 327-343.
• Gatheral, J. (2006). The Volatility Surface: A Practitioner's Guide. Wiley Finance.
• CBOE. "VVIX Index." Chicago Board Options Exchange white paper on volatility-of-volatility indices.