Volatility Covenant Ribbon [JOAT]

Volatility Covenant Ribbon [JOAT]

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