Volatility Covenant Ribbon

The Volatility Covenant Ribbon indicator is a comprehensive volatility-state overlay that measures market expansion, compression, and directional persistence using ATR percentile behavior and directional range separation. It aims to provide traders with a clear visual structure of market volatility, distinguishing between neutral turbulence and directional expansion.

Usage

The Usage section describes how the script can be used to identify different market regimes. Traders can utilize the indicator to determine if the market is in a state of compression (potential breakout setup) or expansion (active trend).

• Volatility States: Users should first check the ATR percentile. High percentiles (typically >80) indicate expansion, while low percentiles (typically <25) suggest compression.
• Directional Imbalance: The script separates bullish and bearish candle ranges. By reading this imbalance, users can distinguish whether an expansion phase is driven by buying or selling pressure.
• Layered Ribbon Context: The inner, middle, and outer ribbons act as dynamic volatility boundaries. Price extending beyond these layers during high-volatility states suggests extreme extensions.
• Expansion Scaffold: When a fresh expansion confirms, the tool can project an informational TP/SL scaffold. This serves as a planning aid for risk-to-reward ratios based on current market volatility.

Details

The script integrates several quantitative concepts to provide a multi-layered view of volatility:

• ATR Percentile Engine: Instead of looking at raw ATR, the script compares current ATR against a rolling history (Percentile Lookback). This contextualizes whether current volatility is high or low relative to recent market behavior.
• Directional Range Separation: By smoothing bullish and bearish ranges separately, the script calculates a "Directional Imbalance." This allows the tool to color-code expansion states based on which side of the market is dominating the range.
• Event-Driven Visuals: The indicator uses forward-projecting "State Boxes" to mark where expansion or compression began, creating a persistent record of volatility regimes on the chart.
• Volatility Score: A proprietary calculation combining ATR percentile, directional imbalance, and price location relative to the basis to determine the overall "state" (e.g., Firm, Heavy, Expansion).

Settings

Volatility Engine

• ATR Length: Sets the lookback period for the Average True Range calculation.
• Percentile Lookback: Determines the window of time used to calculate the ATR's relative rank.
• Ribbon Basis Length: Defines the length of the central EMA that acts as the ribbon's anchor.
• Directional Range Length: The period used to smooth bullish and bearish candle ranges for imbalance calculations.
• Inner/Outer Multiplier: Adjusts the width of the volatility ribbon layers.
• State Threshold: The sensitivity level required to trigger directional expansion states.

State Zones

• Show Expansion/Compression Boxes: Toggles the visibility of the event-driven forward boxes.
• Stored State Boxes: Limits the number of historical boxes displayed on the chart.
• Zone Transparency: Controls the opacity of the expansion and compression zones.

Volatility Scaffold

• Show Expansion Scaffold: Enables the projection of TP/SL levels upon new expansion signals.
• Stop ATR Multiplier: Defines the distance of the stop-loss line based on ATR.
• TP 1/2/3 R: Sets the target levels as multiples of the initial risk distance.

Visual Design

• Show Ribbon/Basis: Toggles the various components of the ribbon overlay.
• Color Candles: When enabled, candles are colored based on the current volatility bias.
• Show Dashboard: Displays a top-right panel containing real-time volatility metrics and scores.

FAQ

How do I interpret the Expansion Boxes? Expansion boxes appear when volatility spikes and the script confirms a directional bias. A green box indicates bullish expansion, while a red box indicates bearish expansion, suggesting a period of high-momentum movement.

What does the Compression state indicate? Compression occurs when the ATR percentile is very low. This typically represents a "coiling" market where price is consolidating, often preceding a significant breakout or expansion phase.

How can I access the Volatility Covenant Ribbon? You can get access on the LuxAlgo Library for charting platforms like TradingView, MetaTrader (MT4/MT5), and NinjaTrader for free.