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
Mã nguồn mở
Theo đúng tinh thần TradingView, tác giả của tập lệnh này đã công bố nó dưới dạng mã nguồn mở, để các nhà giao dịch có thể xem xét và xác minh chức năng. Chúc mừng tác giả! Mặc dù bạn có thể sử dụng miễn phí, hãy nhớ rằng việc công bố lại mã phải tuân theo Nội quy.
The AI Trading Ecosystem, Built to win trades 📈
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Thông báo miễn trừ trách nhiệm
Thông tin và các ấn phẩm này không nhằm mục đích, và không cấu thành, lời khuyên hoặc khuyến nghị về tài chính, đầu tư, giao dịch hay các loại khác do TradingView cung cấp hoặc xác nhận. Đọc thêm tại Điều khoản Sử dụng.
Mã nguồn mở
Theo đúng tinh thần TradingView, tác giả của tập lệnh này đã công bố nó dưới dạng mã nguồn mở, để các nhà giao dịch có thể xem xét và xác minh chức năng. Chúc mừng tác giả! Mặc dù bạn có thể sử dụng miễn phí, hãy nhớ rằng việc công bố lại mã phải tuân theo Nội quy.
The AI Trading Ecosystem, Built to win trades 📈
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Get Full Access 👇
jackofalltrades.vip 🌐
t.me/jackofalltradesvip 🃏
Thông báo miễn trừ trách nhiệm
Thông tin và các ấn phẩm này không nhằm mục đích, và không cấu thành, lời khuyên hoặc khuyến nghị về tài chính, đầu tư, giao dịch hay các loại khác do TradingView cung cấp hoặc xác nhận. Đọc thêm tại Điều khoản Sử dụng.