OPEN-SOURCE SCRIPT
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
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
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
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
오픈 소스 스크립트
트레이딩뷰의 진정한 정신에 따라, 이 스크립트의 작성자는 이를 오픈소스로 공개하여 트레이더들이 기능을 검토하고 검증할 수 있도록 했습니다. 작성자에게 찬사를 보냅니다! 이 코드는 무료로 사용할 수 있지만, 코드를 재게시하는 경우 하우스 룰이 적용된다는 점을 기억하세요.
The AI Trading Ecosystem, Built to win trades 📈
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
면책사항
해당 정보와 게시물은 금융, 투자, 트레이딩 또는 기타 유형의 조언이나 권장 사항으로 간주되지 않으며, 트레이딩뷰에서 제공하거나 보증하는 것이 아닙니다. 자세한 내용은 이용 약관을 참조하세요.
오픈 소스 스크립트
트레이딩뷰의 진정한 정신에 따라, 이 스크립트의 작성자는 이를 오픈소스로 공개하여 트레이더들이 기능을 검토하고 검증할 수 있도록 했습니다. 작성자에게 찬사를 보냅니다! 이 코드는 무료로 사용할 수 있지만, 코드를 재게시하는 경우 하우스 룰이 적용된다는 점을 기억하세요.
The AI Trading Ecosystem, Built to win trades 📈
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
면책사항
해당 정보와 게시물은 금융, 투자, 트레이딩 또는 기타 유형의 조언이나 권장 사항으로 간주되지 않으며, 트레이딩뷰에서 제공하거나 보증하는 것이 아닙니다. 자세한 내용은 이용 약관을 참조하세요.