Volatility State Index

The Volatility State Index (VSI) is a regime detection tool that answers a fundamental question: "Is volatility expanding, contracting, or in transition?"

Understanding volatility state is crucial because different market conditions require different trading approaches. A breakout strategy that works in expanding volatility will fail in decaying volatility. The VSI tells you which regime you're in.

Core Concept

The indicator tracks volatility momentum — not just how volatile the market is, but whether volatility is increasing or decreasing and how stable that trend is.

Three Volatility States

• Expansion (Teal) — Volatility is increasing. Bars are getting larger, ranges are widening. Markets are waking up.
• Decay (Grey) — Volatility is contracting. Bars are getting smaller, ranges are narrowing. Markets are quieting down.
• Transition (Amber) — Volatility momentum is unclear or unstable. The market is between regimes or flickering erratically.

Why This Matters

• Strategy Selection: Breakout strategies work best in expansion. Mean-reversion works best in decay. Transition is danger zone.
• Position Sizing: Larger positions in stable regimes, smaller in transition.
• Stop Placement: Tighter stops in decay (less noise), wider in expansion (more movement).
• Entry Timing: Expansion often follows prolonged decay. Decay often follows climactic expansion.

Key Innovation: Stability Filter

Unlike simple volatility momentum indicators, VSI includes a stability filter that detects when volatility momentum is flickering — changing direction too rapidly to be reliable. This triggers the Transition state, warning you that the market hasn't committed to a regime.

VSI uses a five-stage process to produce clean, actionable volatility state readings.

Stage 1: Base Volatility

Starts with Average True Range (ATR) as the foundation:

Base Volatility = ATR(Length)

ATR captures the average bar range, accounting for gaps.

Stage 2: Smoothed Volatility

Apply EMA smoothing to reduce noise:

Smoothed Volatility = EMA(Base Volatility, Smoothing Length)

This creates a cleaner volatility series for momentum calculation.

Stage 3: Volatility Momentum

Calculate rate of change in smoothed volatility:

Volatility Momentum = (Current Smoothed - Previous Smoothed) ÷ Previous Smoothed
Volatility Momentum (%) = Volatility Momentum × 100

Example: If smoothed ATR was 2.0 ten bars ago and is now 2.2, momentum = (2.2 - 2.0) / 2.0 = 0.10 or +10%.

Stage 4: Stability Filter

Measures how often volatility momentum changes direction:

Momentum Sign = +1 if momentum ≥ 0, else -1
Flip = 1 if sign changed from previous bar, else 0
Flip Rate = SMA(Flip, Stability Lookback)
Stability Score = 1 - Flip Rate

Interpretation: Stability of 0.9 means momentum only flipped 10% of the time — very stable. Stability of 0.4 means it flipped 60% of the time — very unstable.

Stage 5: State Classification with Persistence

Raw state is determined by momentum thresholds:

• Expansion: Volatility Momentum % ≥ Expansion Threshold
• Decay: Volatility Momentum % ≤ Decay Threshold
• Transition: Between thresholds OR Stability Score < Stability Threshold

Persistence filter requires a state to hold for N consecutive bars before confirming, preventing flickering on the output.

Core Settings

ATR Length (Default: 14)

Range: 5–100 bars

Base volatility measurement period. Standard ATR lookback.

• Lower values (5-10): More responsive to recent volatility changes.
• Default (14): Industry standard, balanced responsiveness.
• Higher values (20-50): Smoother base volatility, less reactive to short-term spikes.

Smoothing Length (Default: 10)

Range: 3–50 bars

EMA smoothing applied to the ATR before momentum calculation.

• Lower values (3-5): Minimal smoothing, more reactive momentum readings.
• Default (10): Good balance between responsiveness and noise reduction.
• Higher values (15-30): Very smooth, but lags behind actual volatility changes.

Momentum Length (Default: 10)

Range: 3–50 bars

Period for comparing current vs. past smoothed volatility.

• Lower values: Faster detection of volatility changes, but noisier.
• Default (10): Captures meaningful volatility momentum without excessive noise.
• Higher values: Slower, smoother momentum — good for longer-term regime detection.

State Classification

Expansion Threshold (Default: 5%)

Range: 0.1–50%

Volatility momentum must exceed this percentage to trigger Expansion state.

• Lower values (1-3%): More sensitive, more expansion signals.
• Default (5%): Balanced — requires meaningful volatility increase.
• Higher values (8-15%): Only significant volatility expansions qualify.

Decay Threshold (Default: -5%)

Range: -50% to -0.1%

Volatility momentum must fall below this percentage to trigger Decay state.

• Values closer to 0: More sensitive to volatility contraction.
• Default (-5%): Balanced — requires meaningful volatility decrease.
• More negative values: Only significant volatility contractions qualify.

Persistence Bars (Default: 3)

Range: 1–10 bars

Number of consecutive bars a raw state must hold before becoming confirmed.

• 1: No persistence filter — immediate state changes (may flicker).
• Default (3): Requires state to hold 3 bars — filters most noise.
• Higher values (5-7): Very stable output, but slower to react.

Stability Lookback (Default: 20)

Range: 5–100 bars

Period for measuring how often volatility momentum changes direction.

Stability Threshold (Default: 0.5)

Range: 0.1–1.0

Below this stability score, Transition state is triggered regardless of momentum level.

• Lower values (0.3): Only trigger Transition on very unstable conditions.
• Default (0.5): Balanced — catches meaningfully unstable regimes.
• Higher values (0.7): Stricter — requires high stability to avoid Transition.

Visual Settings

Show State Histogram (Default: On)

Display the main volatility momentum histogram colored by state.

Show Momentum Line (Default: Off)

Display a line plot of volatility momentum for additional visual reference.

Show Zero Line (Default: On)

Display horizontal reference at zero.

Show Background Tint (Default: Off)

Subtle background color during Expansion (teal) and Transition (amber) states.

Histogram Color Coding

• Teal Bars: Expansion state — volatility is increasing.
• Grey Bars: Decay state — volatility is decreasing.
• Amber Bars: Transition state — momentum unclear or unstable.

Understanding Expansion (Teal)

What it means: Volatility momentum is above the expansion threshold and stable.

Market character:

• Bars are getting larger
• Ranges are widening
• Breakouts more likely to follow through
• Trends tend to accelerate

Strategy implication: Favor breakout and momentum strategies. Use trend-following approaches. Allow positions room to run.

Understanding Decay (Grey)

What it means: Volatility momentum is below the decay threshold and stable.

Market character:

• Bars are getting smaller
• Ranges are narrowing
• Consolidation forming
• Breakouts more likely to fail

Strategy implication: Favor mean-reversion and range strategies. Tighten profit targets. Consider reducing position size (less movement to capture).

Understanding Transition (Amber)

What it means: Either volatility momentum is in the neutral zone (between thresholds) OR the stability filter triggered (momentum is flickering).

Market character:

• Volatility direction is unclear
• Market may be shifting between regimes
• Higher uncertainty

Strategy implication: Reduce position size or stand aside. Wait for clearer regime before committing. Transition often precedes significant regime change.

Histogram Height

The histogram shows volatility momentum as a percentage:

• Tall positive bars: Strong volatility expansion (e.g., +15% momentum)
• Tall negative bars: Strong volatility decay (e.g., -12% momentum)
• Short bars near zero: Minimal volatility change

State Transitions to Watch

• Decay → Expansion: Often precedes breakout moves. "Coil and release" pattern.
• Expansion → Decay: Often follows climactic moves. Time to take profits.
• Any state → Transition: Caution — regime is uncertain.
• Prolonged Decay: Building energy — significant move often follows.

Strategy Selection Filter

Use VSI to choose which strategy to deploy:

• Expansion (Teal): Breakout strategies, momentum trading, trend following
• Decay (Grey): Mean reversion, range trading, option selling strategies
• Transition (Amber): Reduce exposure, wait for clarity, or use market-neutral approaches

Position Sizing

• Expansion: Full position size — volatility supports larger moves
• Decay: Reduced size — less movement means smaller profit potential
• Transition: Minimal size — uncertainty warrants caution

Stop Loss Adjustment

• Expansion: Wider stops — expect larger swings, avoid getting stopped by noise
• Decay: Tighter stops — smaller ranges mean stops can be closer
• Transition: Consider time-based exits rather than price-based

Breakout Trading Filter

For breakout strategies:

• Take breakouts: When VSI is in Decay transitioning to Expansion (coil releasing)
• Avoid breakouts: When VSI is in late Expansion (move already extended) or Transition
• Best setup: Prolonged Decay (4+ bars) followed by first teal bar = volatility expanding from compressed state

Mean Reversion Filter

For mean reversion strategies:

• Best conditions: Stable Decay state — price oscillates in narrowing range
• Avoid: Expansion state — fade trades get run over by momentum

Combining with Other Indicators

VSI works well with:

• Market Efficiency Ratio: VSI shows volatility regime, MER shows trend efficiency
• Market State Intelligence: Complete picture — volatility + trend + momentum
• Bollinger Band Width: Similar concept — VSI adds state classification

Timeframe Considerations

• Higher timeframe VSI shows broader volatility regime
• Lower timeframe shows intraday volatility cycles
• Consider using higher TF regime to filter lower TF trades

When "Show Data Window Values" is enabled, access these metrics by hovering over any bar:

ATR (Raw)

The unsmoothed Average True Range value. Shows base volatility in price units.

Use: Compare to historical ATR to understand absolute volatility level.

ATR (Smoothed)

The EMA-smoothed ATR used for momentum calculation.

Use: Watch for divergence between raw and smoothed — indicates short-term volatility spike or dip.

Volatility Momentum (%)

Rate of change in smoothed volatility, expressed as percentage.

• Positive: Volatility is expanding
• Negative: Volatility is contracting
• Near zero: Volatility is stable

Stability Score

Measures consistency of volatility momentum direction (0 to 1).

• 0.8-1.0: Very stable — momentum direction is consistent
• 0.5-0.8: Moderate stability
• Below 0.5: Unstable — triggers Transition state

State (-1/0/1)

Numeric state identifier:

• 1: Expansion
• 0: Transition
• -1: Decay

Is Expansion / Is Decay / Is Transition

Binary flags (1 = true, 0 = false) for each state.

Use: Useful for alerting or strategy automation — check specific state conditions.

Mistake #1: Breakout Trading in Late Expansion

Problem: Taking breakout trades when VSI has been in Expansion for many bars.

Result: Entering at the tail end of a volatility expansion cycle — move exhausts.

Solution: Best breakouts occur when VSI transitions from Decay to Expansion, not after prolonged Expansion.

Mistake #2: Ignoring Transition Warnings

Problem: Trading through Transition state as if it doesn't matter.

Result: Whipsawed by unstable volatility conditions.

Solution: Respect Transition as a "caution" signal. Reduce size or wait for clarity.

Mistake #3: Expecting Immediate State Changes

Problem: Expecting VSI to change state the instant volatility changes.

Result: Frustration when persistence filter delays state confirmation.

Solution: The delay is intentional — it prevents false signals. Watch the momentum reading for early warning.

Mistake #4: Using Same Settings Across All Markets

Problem: Default thresholds may not fit all markets.

Result: Some markets never trigger Expansion, others rarely show Decay.

Solution: Observe your specific market's volatility momentum distribution. Adjust thresholds so you see balanced state occurrence.

Mistake #5: Confusing Volatility with Direction

Problem: Assuming Expansion means bullish and Decay means bearish.

Result: Wrong directional assumptions.

Solution: VSI measures volatility regime, not direction. Expansion can occur in crashes or rallies. Use directional indicators separately.

Mistake #6: Oversmoothing

Problem: Setting smoothing and momentum lengths too high.

Result: VSI lags significantly behind actual volatility changes.

Solution: Keep settings moderate. If VSI state changes feel consistently late, reduce smoothing/momentum lengths.

Tip #1: Watch for "Coil and Release"

Extended Decay periods build energy. When VSI finally shifts to Expansion after 10+ bars of Decay, the resulting move is often significant. This is volatility "coiling" then "releasing."

Tip #2: Use Stability Score Proactively

Watch the stability score in the data window even when not in Transition. Falling stability during Expansion warns that the regime may be ending.

Tip #3: Volatility Cycles

Volatility tends to cycle: Expansion → Decay → Expansion → Decay. Prolonged states in one direction often precede the opposite. Use this for anticipation.

Tip #4: Combine with Volatility Products

If trading VIX futures, options, or volatility ETFs, VSI provides regime context. Expansion favors long volatility, Decay favors short volatility strategies.

Tip #5: News and Events

Scheduled events (FOMC, earnings, etc.) often trigger volatility expansion. Use VSI to confirm when the expansion has started and when it's decaying post-event.

Tip #6: Multi-Timeframe Context

Check higher timeframe VSI for regime context before taking trades on lower timeframe. Daily Expansion with hourly Decay may just be a pullback in a volatile market.

Tip #7: Transition as Opportunity

While Transition is a caution zone, it also signals potential regime change. Monitor Transition closely — the next confirmed state often presents good opportunities.

Tip #8: Options Strategies

VSI is particularly useful for options traders:

• Decay: Sell premium (strangles, iron condors)
• Expansion: Buy premium or directional plays
• Transition: Neutral strategies with defined risk