Volatility Covenant Ribbon [JOAT]Volatility Covenant Ribbon
Introduction
Volatility Covenant Ribbon is an open-source volatility-state overlay that measures expansion, compression, and directional persistence using ATR percentile behavior, directional range separation, layered ribbon bands, event boxes, and an optional TP/SL scaffold when a fresh volatility expansion confirms.
The script is designed to answer whether the market is compressing, expanding, or expanding in a directional way. Many overlays show ATR or band width, but they do not separate directional expansion from neutral turbulence. Volatility Covenant Ribbon addresses that by combining percentile context with directional imbalance and basis location.
Core Concepts
1. ATR Percentile
ATR is compared against its own rolling history to determine whether the market is relatively compressed, neutral, or expanded.
2. Directional Range Separation
Bullish and bearish candle ranges are smoothed separately. Their imbalance helps distinguish upside expansion from downside expansion.
3. Layered Volatility Ribbon
Inner, middle, and outer ATR-based layers are rendered around a central basis to give the chart a volatility structure instead of a single line.
4. Event Boxes
Expansion and compression states are also visualized with forward boxes so the chart keeps a persistent visual record of the current volatility regime.
5. Volatility Scaffold
When a fresh expansion state confirms, the script can draw an informational TP/SL ladder based on ATR-defined risk distance.
Features
ATR percentile engine: Relative volatility classification from rolling ATR history
Directional range imbalance: Distinguishes bullish and bearish expansion pressure
Layered ribbon system: Inner, middle, and outer ribbons around the basis
Expansion and compression states: Separate confirmed conditions instead of one generic volatility reading
State boxes: Event-driven boxes for active expansion or compression
Optional TP/SL scaffold: Informational rails for fresh expansion phases
Top-right dashboard: Shows state, ATR percentile, volatility condition, basis location, direction, score, ATR, and scaffold status
How to Use This Indicator
Step 1: Check whether ATR is in expansion, compression, or neutral territory.
Step 2: Read directional imbalance. This helps distinguish bullish expansion from bearish expansion.
Step 3: Use the ribbon as context for whether price is extending with or against volatility pressure.
Step 4: Treat fresh expansion scaffolds as planning tools, not as certainty.
Indicator Limitations
ATR percentile depends on the selected lookback and can vary across instruments
Directional range separation is a price-derived estimate, not a true order-flow measurement
Compression can persist longer than expected in slow markets
The TP/SL ladder is informational and does not place orders
Originality Statement
Volatility Covenant Ribbon is original in the way it merges relative ATR behavior, directional range imbalance, layered ribbon architecture, event boxes, and execution-style scaffolding into one open-source volatility overlay. It is intended as a volatility context tool rather than a standalone signal generator.
Disclaimer
This indicator is provided for educational and informational purposes only. It is not financial advice. Volatility regimes can shift rapidly and may not lead to directional follow-through. Always use proper risk management and independent analysis.
-Made with passion by jackofalltrades
Pine Script® indicator






















