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
オープンソーススクリプト
TradingViewの精神に則り、このスクリプトの作者はコードをオープンソースとして公開してくれました。トレーダーが内容を確認・検証できるようにという配慮です。作者に拍手を送りましょう!無料で利用できますが、コードの再公開はハウスルールに従う必要があります。
The AI Trading Ecosystem, Built to win trades 📈
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
免責事項
これらの情報および投稿は、TradingViewが提供または承認する金融、投資、取引、またはその他の種類の助言もしくは推奨であることを意図したものではなく、またこれらに該当するものでもありません。詳細は利用規約をご覧ください。
オープンソーススクリプト
TradingViewの精神に則り、このスクリプトの作者はコードをオープンソースとして公開してくれました。トレーダーが内容を確認・検証できるようにという配慮です。作者に拍手を送りましょう!無料で利用できますが、コードの再公開はハウスルールに従う必要があります。
The AI Trading Ecosystem, Built to win trades 📈
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
免責事項
これらの情報および投稿は、TradingViewが提供または承認する金融、投資、取引、またはその他の種類の助言もしくは推奨であることを意図したものではなく、またこれらに該当するものでもありません。詳細は利用規約をご覧ください。