Sentinel Trailing Bench [JOAT]Sentinel Trailing Bench
Introduction
Sentinel Trailing Bench is an open-source contextual trailing-stop overlay designed to behave differently from a standard ATR stop. It blends a sorted price-distribution engine, ATR protection, adaptive recovery behavior, and a benchmark rail so the trailing structure can react to both volatility and local value geometry.
The problem Sentinel solves is stop quality. Simple trailing stops either hug price too tightly in noisy conditions or drift too far away to be useful. Sentinel uses neighborhood structure from a sorted close buffer to estimate contextual bands, then mixes that with ATR logic and recovery tightening when the active side is under pressure.
Core Concepts
1. Sorted distribution engine
The script maintains a rolling close buffer and a sorted mirror of that buffer. This allows it to derive contextual neighborhood slices around the current price instead of relying on ATR alone.
2. Percentile-derived context bands
Supportive and defensive reference levels are estimated from the nearby distribution rather than only from recent swing points.
3. ATR-backed resilience
An ATR anchor remains part of the design so the stop still respects current volatility when distribution structure becomes thin or unstable.
4. Recovery tightening
If price moves materially against the active side relative to the last switch price, the adaptive rail is pulled closer to price to avoid stale trailing behavior.
5. Institutional bench display
The overlay shows the active stop, a benchmark line, the adaptive rail, directional clouding, candle tinting, and a compact dashboard that summarizes trend state, value state, stop gap, and recovery status.
Features
Distribution-aware trailing stop: Uses a sorted close engine and local neighborhood structure
ATR defensive anchor: Keeps the stop grounded in current volatility
Adaptive recovery pull: Tightens the guidance rail when the active side is stressed
Benchmark line and adaptive rail: Adds visual context beyond the raw stop itself
Directional cloud and candle tint: Clean visual bias cues without retail-style arrows
Top-right dashboard: Reports trend state, regime context, value position, stop gap, and recovery status
Confirmed-bar flips: Regime flips are confirmed on closed bars only
Input Parameters
Core:
Distribution Buffer
Neighborhood Radius
ATR Length
ATR Anchor
Benchmark Length
Context:
Distribution Blend
Recovery Threshold xATR
Recovery Pull
Anchor Smoothing
Visuals:
Show Benchmark
Show Adaptive Rail
Show Band Clouds
Color Candles
Show Dashboard
How to Use This Indicator
Step 1: Read the active side
The dashboard and cloud color show whether the stop is currently managing an ascent or descent state.
Step 2: Watch stop gap and rail gap
The dashboard shows how far price sits from the active stop and adaptive rail in ATR terms. This helps frame whether the trailing structure is loose or tight.
Step 3: Monitor recovery
If recovery becomes active, the stop structure is signaling that the current side is under stress and the rail is tightening.
Step 4: Use it as trade management context
Sentinel is most effective as a management tool layered onto entries generated elsewhere.
Indicator Limitations
Distribution-derived bands depend on the sample window and will evolve as new closes enter the buffer
In extremely fast conditions, any trailing stop can still gap beyond the intended exit area
Recovery tightening improves responsiveness but can also accelerate exits in choppy reversals
Originality Statement
Sentinel Trailing Bench is original in how it fuses sorted-distribution neighborhood structure, ATR resilience, and adaptive recovery behavior into one trailing-stop overlay. It is published because:
The stop uses local price distribution context instead of ATR alone
The recovery module changes behavior when the active side is materially under pressure
The benchmark, rail, cloud, and dashboard turn trailing logic into a full management framework rather than a single line
Disclaimer
This indicator is provided for educational and informational purposes only. It is not financial advice and does not guarantee future market behavior. Trailing stops can still be affected by volatility shocks, gaps, and structural changes in the market. Always use independent judgment and proper risk management.
Indicator
Meridian Stochastic Regime Suite [JOAT]Meridian Stochastic Regime Suite
Introduction
Meridian Stochastic Regime Suite is an open-source adaptive oscillator built for traders who want more context than a standard stochastic line can provide. The script combines a centered stochastic engine, an adaptive response model, and a regime profile so the oscillator changes character as the market shifts between trend, compression, expansion, and balance.
The problem Meridian solves is signal quality. Standard oscillators often look clean, but they do not explain whether momentum is occurring inside a compressed market, an expanding breakout phase, or a stable trend. Meridian adds that context directly into the oscillator architecture so the same reading can be interpreted differently depending on the active regime profile.
Core Concepts
1. Centered stochastic architecture
Price is pre-smoothed first, then converted into a stochastic reading that is centered around 50 so directional pressure is easy to interpret:
smoothHigh = ta.ema(high, priceSmoothLen)
smoothLow = ta.ema(low, priceSmoothLen)
smoothClose = ta.ema(close, priceSmoothLen)
rawStoch = 100.0 * (smoothClose - ta.lowest(smoothLow, stochLen)) / stochRange
2. Adaptive response engine
The main oscillator does not use static smoothing alone. Its response speed and gain expand or contract based on the regime profile:
gainBias = gainBase + trendScore * 0.38 + expansionScore * 0.18 - compressionScore * 0.12
speedBias = responseBase + trendScore * 0.08 + expansionScore * 0.04
adaptiveOsc := adaptiveOsc + speedBias * (adaptiveSeed - adaptiveOsc )
This helps the oscillator respond differently in directional and compressed conditions.
3. Embedded regime scoring
Meridian computes four internal state scores:
Trend
Compression
Expansion
Balance
Those scores are derived from ATR behavior, path efficiency, and slope strength, then normalized into a regime profile shown in the dashboard.
4. Spread and signal layer
The script compares the adaptive oscillator to a slower signal line and visualizes the spread around the neutral axis. This gives a direct view of acceleration versus drag.
5. Institutional oscillator panel
The panel uses restrained zones, layered fills, and a top-right dashboard instead of loud markers. The result stays readable while still carrying multiple analytical dimensions.
Features
Centered stochastic core: Keeps the oscillator readable around a neutral midpoint
Adaptive response model: Gain and speed shift with the internal regime profile
Four-state regime map: Trend, Compression, Expansion, and Balance
Fast line and signal line: Shows momentum acceleration versus stabilization
Spread shading: Highlights when the adaptive oscillator is separating from the signal line
Regime dashboard: Displays state, confidence, adaptive reading, signal reading, and regime profile shares
Confirmed-bar flips: Internal state transitions are tracked on closed bars
Non-repainting design: Uses only current-timeframe data and no future references
Input Parameters
Stochastic Core:
Price Pre-Smoothing
Stochastic Length
Fast Smoothing
Adaptive Signal Smoothing
Regime Filter:
Regime Window
ATR Window
Base Oscillator Gain
Base Response Speed
Visual Output:
Show Adaptive Zones
Show Centered Fast Line
How to Use This Indicator
Step 1: Start with the regime
Read the dashboard first. Trend and Expansion regimes support directional interpretation. Compression and Balance call for more caution.
Step 2: Watch adaptive versus signal spread
When the adaptive line separates cleanly from the signal line, momentum is strengthening. When the spread compresses, the move is losing urgency.
Step 3: Use the centered fast line as timing context
The fast line helps show whether short-term momentum is leading or lagging the adaptive engine.
Step 4: Avoid isolated readings
Meridian is strongest when used alongside a structure or value-based tool rather than as a standalone trade trigger.
Indicator Limitations
Like all oscillators, Meridian can remain elevated or depressed during strong directional trends
Compression states may delay re-acceleration readings until volatility expands again
The regime profile is descriptive, not predictive
Originality Statement
Meridian Stochastic Regime Suite is original in how it embeds a four-state regime profile directly into the adaptive behavior of a centered stochastic engine. It is published because:
The oscillator response changes with internal market-state measurements instead of using only fixed smoothing
The script surfaces trend, compression, expansion, and balance as percentages inside the same panel
The panel and dashboard design turn regime context into an interpretable momentum framework rather than a generic stochastic clone
Disclaimer
This indicator is provided for educational and informational purposes only. It is not financial advice or a recommendation to trade. Oscillator readings can remain extreme for extended periods, and regime classifications can shift as conditions evolve. Always use independent judgment and proper risk management.
Indicator
Concordance Allocation Strategy [JOAT]Concordance Allocation Strategy
Introduction
Concordance Allocation Strategy is an open-source PulseWire strategy that integrates regime detection, directional bias, momentum alignment, value-location filtering, and ATR-based risk management into one non-repainting framework. It is designed to trade only when multiple independent layers agree on bar close.
The problem this strategy solves is isolated signal bias. A single good-looking signal can fail quickly if it appears in the wrong market regime, against the wrong directional structure, or in the wrong part of value. Concordance requires those layers to align before it enters a trade, then manages risk with fixed ATR targets and adaptive exits.
Core Concepts
1. Regime filter
The strategy uses a probability-based trend-versus-range classifier. Trades are only considered when the directional regime is confirmed on a closed bar.
2. Directional bias engine
An ATR-based bias band adapts to noisy conditions and recovery stress so long and short bias are not driven by a simple moving average cross.
3. Momentum confirmation
A centered adaptive stochastic spread must align with the directional side. This prevents entries based on trend context alone.
4. Value-location filter
The strategy requires price to be properly aligned with percentile-derived value rails before entries are allowed. This helps avoid chasing direction in poor location.
5. Structured risk management
Every position uses:
ATR stop loss
ATR take profit
Adaptive trailing behavior once price extends far enough
Context exits when regime or momentum deteriorates
Features
Multi-layer entry filter: Regime, bias, momentum, and value must agree
Bar-close confirmation: Entries are evaluated using confirmed-bar logic
ATR stop loss and take profit: Risk is defined from volatility, not fixed ticks
Adaptive exit behavior: Bias band can tighten once the move extends
No higher-timeframe dependency: Uses current-timeframe calculations only
Institutional dashboard: Shows exposure state, regime, momentum, bias band, and value rails
Non-repainting framework: No future references and no lookahead logic
Input Parameters
Regime Layer:
Return Lookback
Volatility Lookback
Efficiency Length
Regime Learning
Trend Gate
Directional Bias:
ATR Length
ATR Base Multiplier
Avoidance Expansion
Recovery Pull
Noise Threshold ATR
Momentum Layer:
Stochastic Length
Stochastic Smoothing
Price Presmoothing
Adaptive Attenuation
Momentum Spread Gate
Value Layer:
Value Lookback
Lower Rail Percentile
Upper Rail Percentile
Rail Smoothing
Risk Layer:
Stop ATR
Take Profit ATR
Trail Activation ATR
Trail Buffer ATR
How to Use This Strategy
Step 1: Read the regime
The strategy only acts when the directional regime is confirmed. If the regime is rotational, it stands down.
Step 2: Confirm directional bias
The ATR bias band must agree with the side of the trade. This avoids taking long momentum setups under bearish structure or the reverse.
Step 3: Check momentum and value together
Momentum must align with the side and price must be operating in the correct value location. Both filters are required.
Step 4: Review risk settings before use
Stop and target multiples should be adjusted to the market and timeframe being tested. The defaults are intended to be realistic rather than aggressively optimized.
Strategy Limitations
No strategy can eliminate false regime transitions or rapid reversals
Percentile value rails adapt to the sample window and may lag sudden structural changes
The strategy is designed for realism and context alignment, not maximum trade frequency
Originality Statement
Concordance Allocation Strategy is original in how it requires regime confirmation, directional bias, momentum agreement, and value-location agreement before allowing entries. It is published because:
The strategy avoids isolated indicator triggers and instead uses a layered confirmation model
Its risk logic combines fixed ATR objectives with adaptive context exits
The design is intentionally current-timeframe, bar-close confirmed, and non-repainting
Disclaimer
This strategy is provided for educational and informational purposes only. It is not financial advice, and backtest results do not guarantee future performance. Trading involves risk of loss, and any strategy can underperform or fail in changing market conditions. Always evaluate settings carefully and use proper risk management.
Strategy
Pulse Entry Engine🚀 Pulse Entry Engine
Pulse Entry Engine is a free momentum-based entry visualization and decision-support indicator designed to help traders analyze potential entry conditions with a cleaner, more structured, and more visual workflow.
This script combines a Special K-based momentum engine, signal modes, confirmation logic, EMA context, higher-timeframe bias filtering, modern oscillator visualization, signal strength scoring, star-based quality labels, TP/SL projection boxes, active-trade candle coloring, signal-candle background highlighting, compact dashboards, visual themes, and dynamic alerts into one organized PulseWire tool.
The goal of Pulse Entry Engine is not to predict the future or provide guaranteed buy/sell instructions.
Its purpose is to help users visually study:
⚡ momentum expansion
🎯 entry-quality conditions
🧭 directional context
📊 signal strength
📦 projected TP/SL zones
🕯️ active-trade candle behavior
🚨 alert-based monitoring
Pulse Entry Engine should be treated as a structured chart-analysis tool, not as financial advice, not as an automated trading system, and not as a guarantee of profitable results.
━━━━━━━━━━━━━━━━━━━━━━
🔓 PUBLICATION NOTE
━━━━━━━━━━━━━━━━━━━━━━
This script is published as a free educational and visual market-analysis tool.
The description is intentionally detailed because many users do not inspect every part of the Pine Script logic line by line.
The purpose of this page is to explain:
✅ what the script does
✅ how the components work together
✅ what appears on the chart
✅ how signals are filtered
✅ how TP/SL projection works
✅ what the dashboards mean
✅ what the limitations are
✅ how the indicator should and should not be used
Pulse Entry Engine is designed to support structured decision-making.
It does not promise profitable results.
It does not remove market risk.
It does not execute trades.
It should not be used as a blind buy/sell system.
It is best used as a visual framework for reviewing momentum, signal quality, context, and projected risk/reward.
━━━━━━━━━━━━━━━━━━━━━━
📌 OVERVIEW
━━━━━━━━━━━━━━━━━━━━━━
At a high level, Pulse Entry Engine does the following:
1. ⚙️ Calculates a Special K-based momentum engine.
2. 📈 Compares the engine value with its signal line.
3. 📏 Measures the distance between the engine and signal line.
4. 🔥 Classifies stretch conditions as Weak, Normal, Strong, or Extreme.
5. 🎯 Generates LONG / SHORT pulse signals when selected conditions align.
6. 🧠 Provides five different Signal Modes.
7. 🕯️ Supports Bar Close and Live Intrabar confirmation.
8. 📈 Includes an EMA-based context filter.
9. 🧭 Includes a Higher Timeframe Bias Filter.
10. ⭐ Calculates a 0–100 signal score.
11. 📊 Displays a Signal Strength Bar.
12. 🌟 Shows star-based quality labels on the main chart.
13. 🟩 Highlights the exact signal candle with a vertical background.
14. 🕯️ Colors candles only while a projected trade is active.
15. 📦 Displays ATR-based TP/SL projection boxes.
16. 🎯 Tracks TP1, TP2, TP3, and SL visually.
17. 🔒 Blocks new signals while an active projection has not reached TP1.
18. 🔁 Allows replacement logic after TP1/TP2 progress.
19. 🌊 Includes a modern oscillator visual engine.
20. 📊 Includes Neon Histogram as the default oscillator view.
21. 🎨 Includes multiple visual themes.
22. 🖥️ Includes Minimal / Pro / Full display profiles.
23. 📋 Includes a compact main dashboard.
24. 📡 Includes a compact live scanning panel.
25. 🚨 Includes standard and dynamic alert messages.
This makes the script more than a simple oscillator or a basic signal marker.
It is a complete visual entry-analysis framework built around momentum, context, signal quality, and projected trade structure.
━━━━━━━━━━━━━━━━━━━━━━
🧠 CORE IDEA
━━━━━━━━━━━━━━━━━━━━━━
The core idea behind Pulse Entry Engine is simple:
A potential entry should not be judged from one isolated condition.
A single oscillator movement, one candle reaction, one stretched reading, or one signal label is usually not enough by itself.
Market context matters.
For that reason, Pulse Entry Engine combines several layers:
⚡ momentum engine direction
📏 distance and stretch expansion
🧭 zero-line context
📈 EMA context
🕰️ higher-timeframe bias
⭐ score requirement
🎛️ signal mode strictness
🕯️ confirmation timing
📦 TP/SL projection logic
The indicator does not attempt to mark every possible move.
Instead, it attempts to make momentum-based entry conditions easier to read, compare, and review.
The purpose is not to create more signals.
The purpose is to make signals more understandable.
━━━━━━━━━━━━━━━━━━━━━━
🧩 WHY THIS SCRIPT IS NOT A SIMPLE BUY/SELL INDICATOR
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine is not intended to behave like a simple “buy here / sell here” script.
It is built as a structured workflow:
Pulse Engine
→ Distance / Stretch Detection
→ Signal Mode Filtering
→ Zero / EMA Context
→ HTF Bias Confirmation
→ Score Classification
→ Star-Based Signal Label
→ TP/SL Projection
→ Active Trade Visualization
→ Dashboard Review
→ Dynamic Alerts
Each part has a specific role.
⚙️ The Pulse Engine measures momentum behavior.
📏 The distance logic identifies meaningful separation from the signal line.
🎛️ The signal modes adjust strictness.
⭐ The score system summarizes confluence strength.
🧭 The HTF filter adds broader directional context.
📊 The dashboard summarizes current conditions.
🌊 The oscillator visualizes momentum behavior.
📦 The TP/SL boxes provide a projected risk/reward structure.
🚨 The alert system helps monitor signals without constantly watching the chart.
This makes the script a full review environment, not a one-condition signal tool.
━━━━━━━━━━━━━━━━━━━━━━
⚙️ HOW THE SCRIPT WORKS
━━━━━━━━━━━━━━━━━━━━━━
1) ⚡ PULSE ENTRY CORE
Pulse Entry Engine uses a Special K-based calculation as its internal momentum engine.
The engine produces two main values:
• the main momentum engine value
• the signal line
The relationship between these two values forms the foundation of the signal logic.
When the engine moves away from the signal line, the script measures the distance between them.
That distance is then compared to its own recent average distance.
This creates the Distance Ratio.
The Distance Ratio helps the script understand whether the current movement is weak, normal, strong, or extreme compared to recent behavior.
This is important because a raw distance between two lines may not mean much by itself.
A distance becomes more meaningful when it is large compared to the engine’s recent average behavior.
━━━━━━━━━━━━━━━━━━━━━━
📏 DISTANCE / STRETCH LOGIC
━━━━━━━━━━━━━━━━━━━━━━
The script calculates:
📌 current distance between engine and signal line
📌 average distance over the selected lookback
📌 distance ratio
📌 strong stretch threshold
📌 extreme stretch threshold
The stretch state can be:
🟤 Weak
🔵 Normal
🟠 Strong
🟣 Extreme
This stretch state appears in the dashboard.
The stretch logic is one of the most important parts of the signal engine.
A signal generally needs the engine distance to be strong enough according to the selected Signal Mode.
This helps reduce reactions to small, random oscillator movements.
━━━━━━━━━━━━━━━━━━━━━━
🎛️ SIGNAL MODES
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes five Signal Modes.
These modes are not only visual names.
They change internal signal thresholds, score requirements, and filtering behavior.
Available modes:
🔥 Aggressive
⚖️ Balanced
⚡ Scalping
🌊 Swing
🛡️ Funded Account
🔥 Aggressive
Aggressive mode is the earliest and most sensitive profile.
It uses lower stretch requirements and a lower score threshold.
This means it can produce more signals and may react faster to developing momentum conditions.
Useful for:
• testing
• manual confirmation
• fast scanning
• active monitoring
• traders who want more potential setups
Important note:
Because it is more sensitive, it may also produce more noise.
⚖️ Balanced
Balanced mode is the default all-around profile.
It uses the user-defined Distance Multiplier and Extreme Stretch settings.
This mode is designed to provide a stable middle-ground behavior.
Useful for:
• general chart review
• standard intraday analysis
• balanced signal frequency
• users who want neither too many nor too few signals
⚡ Scalping
Scalping mode is designed for lower-timeframe active trading environments.
It is faster than Balanced mode but stricter than Aggressive mode.
Useful for:
• M1
• M3
• M5
• fast intraday scanning
• short-term chart review
Scalping mode should still be used with context, risk control, and independent analysis.
🌊 Swing
Swing mode is more selective.
It requires stronger stretch and a higher score threshold.
EMA and Zero filters are forced on for stricter directional context.
Useful for:
• larger market moves
• higher timeframe review
• slower trading style
• fewer but more filtered signals
🛡️ Funded Account
Funded Account mode is the strictest profile.
It requires the strongest internal confirmation among the available modes.
EMA and Zero filters are forced on.
Useful for:
• fewer signals
• stricter filtering
• drawdown-conscious review
• evaluation-style account discipline
• users who prefer cleaner setups
Important note:
This mode does not guarantee safer trades or profitable outcomes.
It only applies stricter internal filtering.
━━━━━━━━━━━━━━━━━━━━━━
🕯️ SIGNAL CONFIRMATION MODE
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes two confirmation modes:
✅ Bar Close
⚡ Live Intrabar
✅ Bar Close
Bar Close mode confirms signals only after the candle closes.
This is the default mode.
It is designed to reduce repaint perception and make signal behavior easier to review historically.
This is generally the cleaner option for alerts and structured review.
⚡ Live Intrabar
Live Intrabar mode allows signals to appear before the candle closes.
This can provide earlier visual feedback.
However, because the candle is still forming, the signal may change before the candle closes.
This mode is faster but less stable than Bar Close confirmation.
━━━━━━━━━━━━━━━━━━━━━━
🧭 ZERO FILTER
━━━━━━━━━━━━━━━━━━━━━━
The Zero Filter uses the oscillator’s zero line as an additional context layer.
In the default logic:
🟢 LONG setups require the engine oscillator to be below zero.
🔴 SHORT setups require the engine oscillator to be above zero.
This creates a reversal-style interpretation.
The idea is that long signals may be more meaningful when the engine is stretched below the zero region, while short signals may be more meaningful when the engine is stretched above the zero region.
Swing and Funded Account modes force this filter on.
━━━━━━━━━━━━━━━━━━━━━━
📈 EMA FILTER
━━━━━━━━━━━━━━━━━━━━━━
The EMA filter adds price-location context.
In this version, the default EMA logic is reversal-oriented:
🟢 LONG setups are allowed when price is below the EMA.
🔴 SHORT setups are allowed when price is above the EMA.
This is not a classic trend-following EMA filter.
It is used to help identify stretched conditions relative to a directional reference.
Swing and Funded Account modes force this filter on.
The dashboard also uses the EMA relationship to display a simple bias state:
🟢 LONG ONLY
🔴 SHORT ONLY
⚪ NEUTRAL
This bias should be treated as context, not as an instruction to trade.
━━━━━━━━━━━━━━━━━━━━━━
🕰️ HTF BIAS FILTER
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes a Higher Timeframe Bias Filter.
Available HTF modes:
⚪ Off
📈 EMA 100
📉 EMA 200
⚙️ Engine HTF
⚪ Off
No higher-timeframe filter is used.
📈 EMA 100
The script checks whether higher-timeframe price is above or below the HTF EMA 100.
Above HTF EMA100 = bullish bias.
Below HTF EMA100 = bearish bias.
📉 EMA 200
The script checks whether higher-timeframe price is above or below the HTF EMA 200.
This is a slower and broader macro filter compared to EMA 100.
⚙️ Engine HTF
The script calculates the engine relationship on the selected higher timeframe.
HTF engine above its signal line = bullish bias.
HTF engine below its signal line = bearish bias.
The HTF filter can help reduce signals that conflict with a broader directional context.
The default HTF timeframe is 60 minutes, but users can adjust it.
━━━━━━━━━━━━━━━━━━━━━━
⭐ SIGNAL SCORE
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine calculates a 0–100 signal score.
The score is based on internal confluence components such as:
⚡ engine direction
📏 stretch strength
🧭 zero filter alignment
📈 EMA filter alignment
🔥 distance strength
The score appears in the dashboard and is also used internally by the selected Signal Mode.
Important note:
The score is not a win-rate prediction.
A score of 85 does not mean the signal has an 85% chance of winning.
It simply means the internal confluence conditions were stronger according to the script’s scoring model.
━━━━━━━━━━━━━━━━━━━━━━
🌟 STAR-BASED MAIN CHART LABELS
━━━━━━━━━━━━━━━━━━━━━━
On the main chart, Pulse Entry Engine uses star-based quality labels.
This keeps the chart cleaner than showing large score numbers directly on every signal label.
Star system:
⭐⭐⭐⭐⭐ = 96–100
⭐⭐⭐⭐ = 92–95
⭐⭐⭐ = 88–91
⭐⭐ = 84–87
⭐ = 80–83
☆ = below 80
Example labels:
▲ LONG PULSE
⭐⭐⭐⭐
▼ SHORT PULSE
⭐⭐⭐
The dashboard still keeps the full numerical score for users who want more detail.
━━━━━━━━━━━━━━━━━━━━━━
📊 SIGNAL STRENGTH BAR
━━━━━━━━━━━━━━━━━━━━━━
The main dashboard includes a Signal Strength Bar.
Example:
█████ 92
████░ 84
███░░ 73
This gives a quick visual representation of the current score.
The strength bar is not a performance statistic.
It does not represent probability or future outcome.
It only visualizes the current internal signal-quality score.
━━━━━━━━━━━━━━━━━━━━━━
🎨 VISUAL THEME SYSTEM
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes three full visual themes:
🟢 Dark Emerald
🔵 Aqua Neon
🟣 Royal Purple
🟢 Dark Emerald
A dark professional theme using green, teal, and cyan accents.
🔵 Aqua Neon
A brighter cyber-style theme using blue, cyan, and pink tones.
🟣 Royal Purple
A premium-looking theme using purple and gold-style accents.
The theme affects:
🎨 dashboard colors
📡 live panel colors
🌊 oscillator colors
📊 histogram colors
🏷️ signal labels
📦 TP/SL boxes
🟢 LONG visuals
🔴 SHORT visuals
🕯️ active-trade candle coloring
🟩 signal-candle background
🚨 visual alert feel
Color inputs are intentionally not exposed in the Inputs tab.
The indicator uses internal theme profiles to keep the settings cleaner and more organized.
━━━━━━━━━━━━━━━━━━━━━━
🖥️ DISPLAY MODE
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes three display profiles:
▫️ Minimal
▪️ Pro
🔳 Full
▫️ Minimal
Minimal mode reduces chart clutter.
It hides many optional visual layers such as dashboards, oscillator dots, gradient zones, pulse backgrounds, and TP level lines.
Useful for clean chart viewing.
▪️ Pro
Pro mode is the balanced default layout.
It uses the user’s individual visibility settings and is designed as the standard V1.0 experience.
🔳 Full
Full mode forces major visual layers on.
Useful for:
🎥 YouTube live streams
📸 screenshots
📚 educational examples
🧪 demonstrations
📊 full feature previews
━━━━━━━━━━━━━━━━━━━━━━
🌊 OSCILLATOR VISUAL ENGINE
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes multiple oscillator display styles.
Available oscillator styles:
📊 Neon Histogram
🌊 Modern Pulse Wave
➖ Clean Line Pro
🕯️ Classic HA
🕯️ Classic Candles
Neon Histogram is the default mode in this version.
📊 Neon Histogram
This mode displays the difference between the engine core and signal line as a histogram.
The histogram helps users quickly read momentum expansion and contraction.
Positive and negative histogram areas are colored according to the selected theme.
🌊 Modern Pulse Wave
This mode displays a smooth pulse wave with soft glow layers and a momentum cloud.
It is designed to look clean, modern, and premium.
➖ Clean Line Pro
This mode provides a simpler line-based oscillator view with less visual noise.
🕯️ Classic HA
This mode keeps the previous Heikin Ashi-style synthetic oscillator candle view.
🕯️ Classic Candles
This mode keeps the previous raw synthetic oscillator candle view.
These modes allow users to choose between a modern histogram, a glowing wave, a minimal line, and legacy oscillator candle styles.
━━━━━━━━━━━━━━━━━━━━━━
🌈 OSCILLATOR SIGNAL DOTS
━━━━━━━━━━━━━━━━━━━━━━
The oscillator panel can show LONG and SHORT signal dots.
In modern modes, the dots can include a glow effect:
✨ larger soft outer dot
● smaller sharp inner dot
This makes signal locations easier to identify in the oscillator panel without large text labels.
These oscillator dots are visual markers only.
They are based on the same signal logic as the main chart labels.
━━━━━━━━━━━━━━━━━━━━━━
⚡ EXTREME STRETCH MARKERS
━━━━━━━━━━━━━━━━━━━━━━
The script can display extreme stretch markers when the engine reaches an extreme distance condition.
These markers highlight stretched momentum conditions.
They are not direct trade signals by themselves.
Their purpose is to show that the engine has moved far away from its recent average relationship with the signal line.
━━━━━━━━━━━━━━━━━━━━━━
📦 TP / SL PROJECTION SYSTEM
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes a TP/SL projection system on the main price chart.
When a new signal appears, the script can draw:
📦 TP box
📦 SL box
🎯 TP1 line
🎯 TP2 line
🎯 TP3 line
🏷️ result label
The system uses ATR-based risk.
Default risk settings:
📌 SL ATR Multiplier = 2.5
📌 Final TP Risk Reward = 1.5R
TP structure:
TP1 = 25% of final TP distance
TP2 = 50% of final TP distance
TP3 = final TP
The boxes are projected forward by an initial number of bars.
Default:
📌 Initial TP/SL Box Length = 10 bars
If the projected trade remains active longer than the initial length, the box continues extending until TP3, SL, or a valid replacement condition occurs.
━━━━━━━━━━━━━━━━━━━━━━
🎯 TP1 / TP2 / TP3 / SL RESULT LOGIC
━━━━━━━━━━━━━━━━━━━━━━
The TP/SL projection system tracks the projected result visually.
Possible result labels:
🟢 TP1
🟢 TP2
🟢 TP3
🔴 SL
If price reaches TP3, the result is marked as TP3.
If price hits SL before reaching any TP level, the result is marked as SL.
If price reaches TP1 and later returns to SL, the result is marked as TP1.
If price reaches TP2 and later returns to SL, the result is marked as TP2.
This means the system remembers the highest target reached before a stop event.
This makes the visual projection more informative than a simple static TP/SL marker.
━━━━━━━━━━━━━━━━━━━━━━
⚠️ SAME-BAR TP/SL HANDLING
━━━━━━━━━━━━━━━━━━━━━━
If TP and SL are both touched on the same candle, there is ambiguity.
The script cannot know the true intrabar sequence unless lower-timeframe reconstruction is used.
For this reason, the script includes a same-bar setting:
If TP and SL Hit Same Bar:
🔴 SL
🟢 TP1
SL is the conservative default.
This allows users to decide how they want same-candle ambiguity to be handled in the visual projection.
━━━━━━━━━━━━━━━━━━━━━━
🔁 ACTIVE TRADE SIGNAL GATE
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes an active projection gate.
If a projected trade is active and has not yet reached TP1, the script blocks new signals.
This prevents the chart from stacking multiple new signals before the previous projection has made minimum progress.
If an active projection has already reached TP1 or TP2 and a new signal appears, the old projection can be closed at its highest reached TP level and the new signal can begin.
This keeps the visual trade structure cleaner and more organized.
━━━━━━━━━━━━━━━━━━━━━━
🕯️ ACTIVE TRADE CANDLE COLORING
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine can color candles while a projected trade is active.
This candle coloring appears only during an active projection.
🟢 During an active LONG projection, candles use the theme long color.
🔴 During an active SHORT projection, candles use the theme short color.
Once the projection closes, candle coloring stops.
This helps users visually identify when the system considers a projected trade to be active.
It is not a separate trading signal.
━━━━━━━━━━━━━━━━━━━━━━
🟩 SIGNAL CANDLE BACKGROUND
━━━━━━━━━━━━━━━━━━━━━━
The script can highlight the exact candle that produced a confirmed signal.
🟢 LONG signal = vertical long-colored background stripe
🔴 SHORT signal = vertical short-colored background stripe
This feature is useful for:
📌 historical review
📌 live chart monitoring
📌 YouTube live streams
📌 educational explanations
📌 quickly locating the original signal candle
━━━━━━━━━━━━━━━━━━━━━━
📋 MAIN DASHBOARD
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes a compact main dashboard.
The dashboard can display:
🎛️ Signal Mode
🎨 Theme
🧭 Bias
🔥 Stretch state
⭐ Score
📊 Strength
🎯 Signal state
🕯️ Confirmation mode
🕰️ HTF Bias
The dashboard is intentionally compact.
It is not designed to be a large performance table.
Its purpose is to summarize the current engine state and help users understand what the script is currently reading.
Dashboard position and size can be adjusted from the settings.
━━━━━━━━━━━━━━━━━━━━━━
📡 LIVE SCANNING PANEL
━━━━━━━━━━━━━━━━━━━━━━
The script includes a compact Live Scanning panel.
The live panel displays the Pulse Entry Engine live scanning state in a clean visual format.
The lower information row was intentionally removed to keep the chart cleaner.
Users can adjust:
📍 Live Panel Position
🔠 Live Panel Size
● Live blinking status symbol
The live panel is visual only.
It does not affect signal logic.
━━━━━━━━━━━━━━━━━━━━━━
🚨 ALERT SYSTEM
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine includes both standard alert conditions and dynamic alert messages.
Standard alertcondition alerts include:
🟢 LONG signal
🔴 SHORT signal
⚡ LONG/SHORT signal
🔥 Extreme stretch detected
The script also includes dynamic alert messages using alert().
The dynamic alert message can include:
📌 indicator name and version
📌 signal direction
📌 ticker
📌 timeframe
📌 Signal Mode
📌 Confirmation Mode
📌 HTF Bias
📌 Score
📌 Stretch
📌 ATR risk setting
📌 TP RR setting
Important usage note:
To use the full dynamic alert message, create a PulseWire alert with:
Condition: Pulse Entry Engine
Option: Any alert() function call
The standard alertcondition options can still be used as simpler fallback alerts.
━━━━━━━━━━━━━━━━━━━━━━
🧪 HOW TO USE THE INDICATOR
━━━━━━━━━━━━━━━━━━━━━━
A practical workflow:
1. Add Pulse Entry Engine to your chart.
2. Start with the default Pro display mode.
3. Choose a visual theme that fits your chart.
4. Select your Signal Mode.
5. Use Bar Close confirmation for cleaner signal review.
6. Choose whether to enable the HTF Bias Filter.
7. Watch the oscillator histogram for momentum expansion.
8. Review the dashboard for score, stretch, signal state, and HTF bias.
9. When a LONG or SHORT pulse appears, check the star rating.
10. Look at the signal candle background highlight.
11. Review the TP/SL projection box.
12. Observe whether the projection reaches TP1, TP2, TP3, or SL.
13. Use alerts if you want automated signal notifications.
14. Validate the indicator on the specific markets and timeframes you personally study.
The indicator is best used as a structured decision-support tool.
It should not be used as a blind execution system.
━━━━━━━━━━━━━━━━━━━━━━
⚙️ SETTINGS REFERENCE
━━━━━━━━━━━━━━━━━━━━━━
🎯 Signal Logic
Source
Selects the price source used by the Pulse Entry Engine core.
Signal Length 1
Primary engine calculation length.
Signal Length 2
Secondary engine calculation length.
Signal Mode
Selects the main signal preset:
🔥 Aggressive
⚖️ Balanced
⚡ Scalping
🌊 Swing
🛡️ Funded Account
Signal Confirmation Mode
Controls when a signal is allowed to confirm:
✅ Bar Close
⚡ Live Intrabar
Average Distance Length
Lookback length used to calculate average distance between engine and signal line.
Distance Multiplier
Balanced mode stretch threshold.
Extreme Stretch Multiplier
Balanced mode extreme stretch threshold.
Reset When Distance Gets Weak
Allows the internal signal state to reset when distance becomes weak.
Reset Multiplier
Defines how weak the distance must become before reset.
Use Zero Filter
Enables zero-line filtering.
📈 EMA Filter
Use EMA Filter
Enables the EMA context filter.
EMA Length
EMA length used for the filter and dashboard bias.
🧭 HTF Bias Filter
HTF Bias Mode
Available modes:
⚪ Off
📈 EMA 100
📉 EMA 200
⚙️ Engine HTF
HTF Timeframe
Higher timeframe used by the HTF filter.
🎨 Style
Visual Theme
Available themes:
🟢 Dark Emerald
🔵 Aqua Neon
🟣 Royal Purple
Display Mode
Available profiles:
▫️ Minimal
▪️ Pro
🔳 Full
Oscillator Visual Mode
Available styles:
📊 Neon Histogram
🌊 Modern Pulse Wave
➖ Clean Line Pro
🕯️ Classic HA
🕯️ Classic Candles
Show Signal Line
Shows or hides the engine signal line.
Show Momentum Cloud
Shows the oscillator momentum cloud.
Show Zero Zone
Shows the oscillator zero zone.
Zero Zone Width
Controls the width of the zero zone.
Show Gradient Background Zones
Shows subtle oscillator background zones.
Show Extreme Stretch Markers
Shows extreme stretch pulse markers.
Show Oscillator Pulse Glow
Adds glow layers to modern oscillator visuals.
Show Neon Histogram
Controls histogram visibility when Neon Histogram mode is selected.
Show Oscillator Signal Dots
Shows LONG/SHORT dots in the oscillator panel.
Show Main Chart LONG / SHORT Labels
Shows signal labels on the main chart.
Main Chart Label Offset ATR
Controls how far signal labels are placed from price.
Show Main Chart Dashboard
Shows or hides the main dashboard.
Dashboard Position
Controls dashboard location.
Dashboard Size
Controls dashboard text size.
Show Main Chart Live Dashboard
Shows or hides the live scanning panel.
Live Panel Position
Controls live panel location.
Live Panel Size
Controls live panel text size.
Show Signal Pulse Background
Shows a soft background pulse when a signal appears.
Show Signal Candle Background
Highlights the exact signal candle with a vertical background.
Signal Candle Background Transparency
Controls the transparency of the signal candle highlight.
Color Candles During Active Trade
Colors price candles only while a projected trade is active.
Active Trade Candle Transparency
Controls active-trade candle coloring transparency.
Use Live Blinking Status Symbol
Enables the blinking live scanning dot.
Live Symbol Blink Seconds
Controls blink speed.
📦 TP / SL Box System
Show TP / SL Boxes on Main Chart
Enables TP/SL projection boxes.
SL ATR Length
ATR length used for stop-loss calculation.
SL ATR Multiplier
ATR multiplier used for SL distance.
Final TP Risk Reward
Final TP target multiple:
1R
1.5R
2R
3R
4R
5R
Max Stored TP / SL Trades
Maximum historical projection objects kept on chart.
If TP and SL Hit Same Bar
Controls same-bar ambiguity handling.
Show TP1 / TP2 / TP3 Lines
Shows TP level lines inside the projection box.
Initial TP / SL Box Length
Initial forward length of projection boxes.
Show TP / SL Result Label
Shows result labels after projected trade closes.
🛡️ Professional Controls
Max Main Signal Labels
Limits the number of main-chart signal labels to protect PulseWire object limits.
Enable Dynamic Alert Messages
Enables alert() based dynamic alert messages.
Show Version Badge
Shows the V1.0 badge in the visual panels.
━━━━━━━━━━━━━━━━━━━━━━
🧠 WHAT MAKES THIS SCRIPT ORIGINAL
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine uses familiar concepts such as:
⚡ oscillator momentum
📈 signal lines
🧭 EMA context
🕰️ higher-timeframe filtering
📦 ATR-based risk projection
📊 dashboards
🚨 alerts
These components are not unique by themselves.
The originality of the script lies in how these components are organized into one workflow:
Pulse Engine
→ Stretch Detection
→ Signal Mode Filtering
→ Score Classification
→ HTF Bias Confirmation
→ Modern Oscillator Visualization
→ Star-Based Quality Label
→ TP/SL Projection
→ Active-Trade Candle Coloring
→ Compact Dashboard
→ Dynamic Alerts
This structure is intended to give users a more organized way to review momentum-based entries.
━━━━━━━━━━━━━━━━━━━━━━
⚠️ IMPORTANT PRACTICAL NOTES
━━━━━━━━━━━━━━━━━━━━━━
The script’s behavior depends heavily on settings.
Signal frequency and visual output may change based on:
🎛️ selected Signal Mode
🕯️ confirmation mode
📈 EMA filter setting
🧭 HTF bias mode
🌊 oscillator visual mode
🖥️ display profile
📏 ATR multiplier
🎯 TP RR setting
📊 market
⏱️ timeframe
📉 symbol volatility
📚 available historical bars
A mode that appears cleaner on one symbol may not behave the same way on another.
The TP/SL boxes are visual projections based on the script’s rules.
They are not broker orders.
They do not account for real execution conditions.
━━━━━━━━━━━━━━━━━━━━━━
⚠️ LIMITATIONS AND SHORTCOMINGS
━━━━━━━━━━━━━━━━━━━━━━
This script has important limitations:
❌ It does not guarantee profitable trades.
❌ It does not predict future price movement.
❌ It does not replace risk management.
❌ It does not execute trades.
❌ It does not place orders.
❌ It does not include broker slippage.
❌ It does not include commissions.
❌ It does not include spreads.
❌ It uses bar-based chart data.
❌ Same-bar TP/SL order is approximated by a user-selected rule.
❌ Live Intrabar mode may change before candle close.
❌ Higher-timeframe filters can lag.
❌ EMA filters can conflict with certain market structures.
❌ Momentum signals can fail in choppy markets.
❌ Strong scores do not guarantee successful outcomes.
❌ TP/SL projections are visual analysis tools, not trade instructions.
❌ Historical visual behavior does not ensure future behavior.
For these reasons, Pulse Entry Engine should be used as an educational decision-support tool, not as a standalone trading strategy.
━━━━━━━━━━━━━━━━━━━━━━
👤 WHO THIS SCRIPT MAY BE USEFUL FOR
━━━━━━━━━━━━━━━━━━━━━━
This script may be useful for traders who:
✅ study momentum-based entries
✅ want a structured entry review tool
✅ want a clean visual dashboard
✅ want higher-timeframe context
✅ want ATR-based TP/SL projection
✅ want signal strength scoring
✅ want modern oscillator visuals
✅ want star-based quality labels
✅ want active-trade candle coloring
✅ want dynamic alerts
✅ prefer organized chart-based analysis
✅ want a free visual trading assistant for review and education
It may be less suitable for users who:
❌ want guaranteed buy/sell signals
❌ want a fully automated trading bot
❌ do not want chart visuals
❌ do not use technical analysis
❌ expect one setting to work on every market
❌ want an indicator that replaces their own decision-making
━━━━━━━━━━━━━━━━━━━━━━
🧭 BEST PRACTICE SUGGESTIONS
━━━━━━━━━━━━━━━━━━━━━━
For cleaner review:
✅ Start with Bar Close confirmation.
✅ Start with Balanced or Funded Account mode.
✅ Use HTF Bias only when you want broader directional filtering.
✅ Use Minimal display mode if the chart feels crowded.
✅ Use Full display mode for screenshots, education, and live demonstrations.
✅ Review signals together with market structure.
✅ Avoid treating every label as an automatic trade.
✅ Test the indicator on the specific symbols and timeframes you actually watch.
✅ Combine the tool with your own analysis and risk rules.
━━━━━━━━━━━━━━━━━━━━━━
🛡️ DISCLAIMER
━━━━━━━━━━━━━━━━━━━━━━
Pulse Entry Engine is provided for educational and informational purposes only.
It does not constitute financial, investment, or trading advice.
No indicator can guarantee future results.
Markets are uncertain, conditions change, and historical behavior does not ensure future performance.
Every user is responsible for their own analysis, validation, risk management, position sizing, and trading decisions.
Use this script as a structured decision-support and visual review framework, not as a promise of profitability. Indicator
Volatility Coil Edge [BullByte]Volatility Coil Edge is a reversal detection script designed for intraday traders operating in futures, indices, and crypto markets. It identifies a specific and repeatable market condition: price compressing into a tight range at the extreme boundary of a session, then breaking out of that compression in the opposing direction. The compression is the footprint. The break is the trigger. Everything else - entry, stop, and three scaled targets - is calculated automatically from the structure itself.
This script is built from custom logic rather than a simple wrapper of standard indicators. VCE is built from a custom volatility state machine designed specifically for detecting absorption-and-release patterns at session extremes. There is no RSI. No MACD. No Bollinger Band. The logic is derived entirely from price geometry, ATR ratio mathematics, and session range physics.
---
WHAT IS A VOLATILITY COIL
Price does not move in straight lines. It expands and contracts in cycles . When price reaches the edge of its established session range and begins contracting - forming smaller and smaller bars with decreasing volatility relative to recent history - it is coiling. This coil represents a temporary equilibrium between buyers and sellers at a structurally significant location.
The coil at a session high means sellers have been absorbing every attempt to push higher. The coil at a session low means buyers have been absorbing every attempt to push lower. When that absorption ends and price breaks through the coil boundary in the reversal direction, it signals that one side may be losing control and the opposite side may begin to take over.
VCE detects this moment and marks it on the close of the break bar. The script combines session-extreme context, multi-condition compression logic, violation tolerance, and post-impulse detection within one unified engine.
---
WHY THIS WORKS AND WHY IT IS ORIGINAL
Most volatility indicators measure contraction globally across the entire chart. VCE measures contraction locally and contextually - it only cares about compression that forms at the edges of the current session range. A tight range forming in the middle of a session is noise. The same tight range forming at the session high or low is a structural event.
The detection engine uses three simultaneous compression conditions:
The first is a ratio comparison between a short-period local ATR and a longer-period background ATR . When the local ATR falls below a calibrated percentage of the background ATR, the bar qualifies as contracted.
The second is a drift-floor condition that catches low-volatility regimes where the ratio test alone would miss genuine compressions. It compares the current bar range against the rolling median bar range.
The third is Catalyst Mode, which identifies compressions forming immediately after a volatility expansion - the post-impulse coil. These are often a strong setup type because they represent price stalling after a strong directional move, often marking exhaustion at the extreme.
All three conditions feed a state machine that tracks how many consecutive bars meet the compression criteria, applies violation tolerance so that minor range extensions do not invalidate real coils, and enforces a maximum coil length to prevent stale consolidations from triggering signals.
---
THREE SENSITIVITY TIERS
Conservative: Requires the tightest compression and the longest minimum coil duration. Generates fewer signals. Best for traders who prefer higher-filter setups and can wait.
Balanced: The recommended default. Moderate compression requirements and signal frequency. Suitable for most intraday traders across all supported markets.
Aggressive: Captures looser compressions and shorter coils. Higher signal frequency. Best for very active scalpers who want early entries and manage risk with tight stops.
All three tiers can be fully overridden with manual parameter control for experienced users who want to calibrate to a specific instrument.
---
CATALYST MODE
When enabled, Catalyst Mode adds a fourth detection layer. If any of the last five bars showed a range greater than 1.5 times the background ATR, the engine recognizes that a volatility expansion just occurred. Compressions forming immediately after an expansion are flagged even if the ratio test alone would not qualify them. These post-impulse coils frequently mark the confirmed point where momentum stalls and reversal begins.
---
SIGNAL MECHANICS
This tool provides a systematic framework for identifying the pattern and managing the trade once it fires. A historical bar is exactly what you would have seen in real time on that bar's close.
LONG signals fire when a qualified compression forms at the session low zone and price closes above the upper boundary of the coil on the break bar.
SHORT signals fire when a qualified compression forms at the session high zone and price closes below the lower boundary of the coil on the break bar.
---
ENTRY, STOP, AND TARGETS
Entry is the close price of the signal bar.
The stop loss is placed beyond the structural extreme of the coil - below the coil low for longs, above the coil high for shorts - with an ATR buffer added for breathing room. A minimum stop distance floor prevents dangerously tight stops on very small coils.
The stop distance itself is bounded between an ATR floor and an ATR ceiling so that all three targets remain proportionally realistic regardless of coil size. Targets are then calculated as pure R-multiples of the final bounded stop distance:
TP1 defaults to 1.0R - the point where the trade has covered its own risk.
TP2 defaults to 1.5R - the primary partial profit zone.
TP3 defaults to 2.0R - the full target. Hitting TP3 closes the trade and removes all drawings.
TP1 and TP2 are milestone targets. When hit, a yellow dot marks the price level and the trade remains open. The stop loss and all three target lines remain live until TP3 or the stop is reached.
All R-multiple values are user-adjustable. The stop buffer and minimum distance are also adjustable.
---
VISUAL ELEMENTS
Signal Card: A labeled marker appears at every signal bar showing direction (LONG or SHORT), the number of bars in the coil, and the TP2 R-multiple. In Minimalist mode, only the direction is shown. Signal cards are permanent - every historical signal remains visible for review.
Level Lines: At signal time, five horizontal lines are drawn - entry, stop loss, TP1, TP2, TP3 - each with a floating price label to the right. Lines extend forward bar by bar during the trade and terminate cleanly at the outcome bar.
Coil Box: While a compression is being watched, a dashed orange box outlines the coil range. The box updates in real time as the coil extends. A small tag shows direction bias and bar count.
Concentric Rings: Four nested rings are drawn around the signal bar at entry, scaling with ATR. They persist for the duration of the trade as a visual anchor and are removed automatically at outcome.
Milestone Dots: Yellow dots mark the exact bar and price where TP1 and TP2 are touched during the trade.
Signal Bar Highlight: The background of the signal bar is tinted green for longs and red for shorts.
---
THE DASHBOARD
The dashboard panel shows the current state of the engine at a glance. It updates on every bar close.
The header shows the ticker symbol and timeframe so the panel is always self-identifying across multiple open charts.
STATE shows one of four conditions: IDLE when no coil is active, FORMING with a bar count when compression is building but not yet qualified, WATCH LONG or WATCH SHORT when a qualified coil is positioned at an extreme and the engine is waiting for a break, and ACTIVE LONG or ACTIVE SHORT during a live trade.
COIL shows the current compression bar count and the local-to-background ATR ratio as a percentage. Lower percentage means tighter compression.
ZONE shows where the active coil is positioned - session high, session low, or mid-range for forming coils that have not yet reached an extreme.
ENTRY shows the direction and confirmed entry price of the active trade.
TARGETS shows three dots - one for each TP level. Dots fill yellow as each milestone is hit during the trade.
---
RECOMMENDED MARKETS AND TIMEFRAMES
VCE is designed for liquid intraday markets with defined session structure. It performs better on instruments that have clear daily range boundaries and regular volatility patterns.
Recommended markets: NQ, ES, MNQ, MES futures. BTC, ETH, SOL perpetual futures. Major crypto spot pairs. SPY, QQQ intraday.
Recommended timeframes: The script performs strongest on the 15 minute timeframe where session structure is cleanest and compression patterns carry the most weight. The 5 minute and 3 minute timeframes are well suited for standard intraday work. The 1 minute timeframe is for aggressive scalping and requires tighter risk management due to higher noise levels.
The Session Range Lookback input should be calibrated to approximately one full session worth of bars on your chosen timeframe. On a 5-minute chart, one RTH session is roughly 78 bars. On a 1-minute chart, approximately 390 bars. The default of 50 is a balanced starting point for 3-minute and 5-minute charts.
On a 15-minute chart one full RTH session is approximately 26 bars; set Session Range Lookback to 26 to 30 for clean session-extreme detection on this timeframe.
---
HOW TO READ A LIVE SETUP (USAGE)
Step one : Watch for the dashboard STATE to change from IDLE to FORMING. This means compression is building somewhere on the chart.
Step two: When STATE changes to WATCH LONG or WATCH SHORT, the coil has qualified and is positioned at a session extreme. The orange coil box becomes visible. The engine is now armed.
Step three: Do not act on WATCH alone. Wait for the signal card to appear. The signal only fires on bar close when the coil has been broken in the reversal direction. The signal card, level lines, and rings all appear simultaneously at that moment.
Step four: Entry is the close of the signal bar. Place your stop at the SL line. Your targets are TP1, TP2, and TP3 as shown on the chart.
Step five: TP1 and TP2 mark themselves with yellow dots as they are hit. The trade closes automatically in the visual display when TP3 or SL is reached, and all lines are removed cleanly.
CHART EXAMPLE
The Science of Price Coiling : Silver 5m
Price surged aggressively into the session high zone, driven by strong buying momentum. But at the extreme, buyers ran out of fuel. Over the next 4 bars, the range shrank bar by bar, candles got smaller, volatility dried up, and neither buyers nor sellers could dominate.
This is the coil: not random sideways movement, but compressed energy at an unstable equilibrium. The longer price holds at an extreme without continuing, the more it signals that the side that drove it there is exhausting. When sellers finally overwhelmed the weakened buyers, price broke below the coil floor in a single decisive bar, releasing all stored tension in one direction.
That break was not a prediction. It was a consequence. The compression was the warning, the location was the context, and the break was simply the market resolving the imbalance it had been building. This is what VCE detects, not the move itself, but the conditions that make the move inevitable.
---
ALERT SETUP
Two alert conditions are built in:
VCE Long Signal fires on bar close when a LONG setup triggers.
VCE Short Signal fires on bar close when a SHORT setup triggers.
To activate : open the Alerts panel, select Create Alert, choose VCE as the condition source, and select either Long Signal or Short Signal. Set the trigger to Once Per Bar Close. No additional configuration is needed.
---
INPUTS REFERENCE
Sensitivity: Conservative, Balanced, or Aggressive preset. Controls compression tightness, minimum coil length, zone threshold, and break definition simultaneously.
Catalyst Mode: Enables post-impulse coil detection. Recommended ON for all markets.
Use Manual Overrides: Replaces the sensitivity preset with the four manual parameters below it.
Min Bars: Minimum consecutive compression bars required before a coil qualifies.
Max Bars: Maximum coil length before the coil is invalidated and reset.
Contraction Ratio: Local ATR must be below this fraction of the background ATR to register as a compressed bar.
Extreme Zone Percent: Defines what fraction of the session range constitutes the high and low extreme zones.
Background ATR Period: Smoothing period for the volatility baseline used in compression detection.
Session Range Lookback: Number of bars defining the rolling session high and low.
ATR Period: Period for the ATR used in stop and target calculations.
Post-Outcome Bar Gap: Minimum bars of silence after a trade closes before the next signal can fire.
SL Buffer: ATR multiplier added beyond the coil extreme when calculating the structural stop.
Min SL Distance: Floor for the stop distance as an ATR multiple. Prevents unrealistically tight stops.
Max SL Distance: Ceiling for the stop distance as an ATR multiple. Prevents absurdly wide stops on tall coils and keeps all TP levels proportionally realistic for the chosen timeframe.
TP1, TP2, TP3: Take-profit levels as multiples of the stop distance.
Label Right Offset: Controls how far to the right floating price labels appear.
Minimalist Signal Card: Shows only LONG or SHORT on the signal card when enabled.
Show Coil Box: Toggles the live orange compression box.
Highlight Signal Bar: Toggles background tinting on signal bars.
Show Concentric Ring Signature: Toggles the nested ring visual at signal bars.
Show Dashboard: Toggles the status panel.
Theme: Dark or Light. Adjusts all label, line, and panel colors for chart background compatibility.
Position: Sets the dashboard anchor position on the chart.
---
NOTES ON PERFORMANCE AND EXPECTATIONS
VCE identifies a specific structural pattern. Not every coil produces a sustained reversal. Session context, macro flow, and news events all influence whether a given setup follows through. The tool provides a systematic framework for identifying the pattern and managing the trade once it fires. Risk management decisions remain with the trader.
The post-outcome bar gap input exists to prevent the engine from immediately re-entering after a stopped trade. This is a deliberate design choice, not a limitation.
---
DISCLAIMER
This script is published for educational and informational purposes only. It is not financial advice and does not constitute a recommendation to buy or sell any financial instrument. Past signal behavior does not guarantee future results. Trading involves significant risk of loss. Always conduct your own research and apply your own risk management framework before making any trading decision. Indicator
ADX Filtered Average True RangeOverview
This indicator combines ATR-based volatility measurement with ADX directional filtering to highlight only those moments when volatility expansion is aligned with confirmed trend momentum. Raw ATR measures how much price moves per bar, but a rising ATR alone says nothing about direction or conviction. By layering an ADX filter on top, the indicator separates meaningful expansion — where volatility is growing in the direction of a strengthening trend — from choppy noise where volatility rises without directional follow-through.
The result is a two-signal system displayed in a separate pane: a smoothed ATR line that changes colour only when the trend is directionally confirmed, and a background highlight that activates only when all three conditions align — expanding ATR, a rising directional ADX signal, and a bar that closes in the direction of the trend. This gives traders a compact, at-a-glance read on whether current volatility is actionable or should be ignored.
The indicator is designed for swing and intraday traders on instruments with clear trending behaviour, such as NSE:NIFTY , NSE:BANKNIFTY , MCX:CRUDEOIL1! , and major crypto pairs.
How It Works
ATR is calculated by applying the selected smoothing method to the true range series. A second SWMA pass (smoothed ATR, atrs ) acts as a baseline — when raw ATR rises above atrs and atrs itself is also rising, the indicator treats volatility as actively expanding:
atr = ma_function(ta.tr(true), atrlen)
atrs = ta.swma(atr)
ATRExpanding = (atrs > atrs and atr > atrs)
The ADX filter uses Pine's native ta.dmi() to compute DI+, DI−, and raw ADX. A SWMA of ADX ( sadx ) acts as the directional baseline. Bullish ADX is confirmed when sadx is rising, ADX is above sadx , DI+ shows momentum or dominance over DI−, and DI+ is above 15. Bearish ADX mirrors this using DI−:
sadx = ta.swma(adx)
ADXUp = sadx > sadx and adx > sadx and (diplus > diplus or diplus > diminus) and diplus > 15
ADXDn = sadx > sadx and adx > sadx and (diminus > diminus or diminus > diplus) and diminus > 15
Background highlighting only fires when all three conditions are simultaneously true — expanding volatility, directional ADX confirmation, and a bar closing in the expected direction.
Colour key:
Dark red line — raw ATR; always visible as the volatility baseline
Thick white line — smoothed ATR (SWMA of ATR); the trend-adjusted volatility baseline
Green background — ATR expanding + bullish ADX confirmed + bullish bar (close > open)
Red background — ATR expanding + bearish ADX confirmed + bearish bar (close < open)
No background — ATR contracting, or ADX directional filter not met, or bar indecisive
Inputs
ATR – Length — Number of bars used to smooth the true range for ATR calculation. Constrained to the Fibonacci sequence for harmonic alignment. Low (e.g. 5): fast, reactive ATR that tracks short-term volatility spikes. High (e.g. 55): slow, structural ATR that filters out minor fluctuations. Default: 13.
Smoothing — MA method applied to the true range when computing ATR. RMA (Wilder's moving average) is the industry standard and matches most platform ATR implementations. SWMA is the most responsive with zero lag; VWMA incorporates volume weight. Default: RMA.
ADX – Length — Lookback period for the DMI/ADX calculation via ta.dmi() . Low (e.g. 8): ADX responds faster, triggers more frequently but with more false positives. High (e.g. 55): ADX requires sustained directional pressure before confirming. Default: 34.
ADX – Smoothing — Smoothing period applied inside ta.dmi() to derive the signal line (lensig). Low (e.g. 1): raw, unsmoothed ADX. High (e.g. 13): heavily smoothed ADX that lags but reduces whipsaws. Default: 3.
Usage Notes
A green or red background is a confluence signal, not a standalone entry. Use it to confirm setups identified on your primary chart — price action, structure, or another trend tool.
When the background is absent despite a strong price move, treat this as a caution flag. Either ATR is contracting (move may be running out of energy) or ADX disagrees with direction (possible counter-trend move).
The DI threshold of 15 acts as a minimum directional noise filter. In low-volatility instruments or compressed consolidation phases, ADX rarely satisfies this condition — this is intentional behaviour, not a bug.
The Fibonacci-constrained length inputs encourage harmonic consistency across ATR and ADX settings. Consider pairing lengths that share a ratio — for example ATR 13 with ADX 34, or ATR 21 with ADX 55.
On shorter timeframes (1m–5m), set ATR Length to 5 or 8 and ADX Length to 13 or 21 for responsive signals. On daily or weekly charts, 34/89 or 55/144 combinations work well.
This indicator plots in a separate pane. Keep your price chart uncluttered — the background colour bleeds through to the main chart, providing context without requiring you to watch the pane constantly.
Recommended Pairings
This indicator pairs well with a trend-following overlay such as a Hull MA, VWAP, or a multi-timeframe EMA ribbon to confirm the broader bias before the background activates. Volume indicators — particularly Volume Delta or On-Balance Volume — add a useful layer of confirmation when the background fires, helping distinguish absorption-driven moves from thin-market noise. For Indian derivative traders, pairing with an open-interest change indicator on NSE:NIFTY or NSE:BANKNIFTY options can sharpen entry timing during background signals. Indicator
ATR Volatility Regime [NovaLens]Volatility regime tool built to separate two things ATR alone cannot tell you apart: where volatility currently sits in its own rolling history, and which direction the regime is rotating. Adds a velocity-gated release event on top, so the indicator flags fast coiled-spring releases on the confirmed bar - and refuses to fire on the slow leaks that only look like one.
Most volatility tools collapse one axis. A raw ATR plot tells you the bar range and nothing about whether that range is rare. A percentile-rank histogram tells you the rank but not whether vol is loading or unloading. ATR Volatility Regime separates the two by design:
Tier tracks where volatility sits in its own rolling history (Compression / Quiet / Normal / Elevated).
Phase tracks where volatility is rotating (Rising / Topping / Falling / Bottoming).
A Compression reading is not a breakout signal. It is the market saying "vol is loaded." Whether it actually releases depends on the next move. When a sustained compression actually breaks above mid-rank within a 5-bar velocity window, the indicator prints a Release diamond and pulses the pane background. Slow leaks that drift through Quiet for more than 5 bars are canceled, not reported. That single gate is what separates a real coiled-spring release from a sideways drift.
════════════════════════════════════════════
◉ HOW IT WORKS
The vol input. Wilder ATR over the chosen length, expressed as a percentage of close so the read is comparable across price levels and instruments. Mathematically guarded to stay clean across historical data gaps and unusual price series.
The percentile rank. The current ATR% is ranked against its own rolling lookback window (100 / 200 / 300 bars by Horizon). This is an asset-calibrated percentile - "P75 on BTC" means "vol higher than 75% of the last 200 BTC readings," not a market-wide cutoff. The same indicator works across SPY, BTC, EURUSD, and XAU without retuning. The raw rank drives the state engine; an EMA-smoothed copy drives the visual line so the plot reads calm without numbing event detection. Warm-up is honest: until the lookback fills, the panel shows "Warming up" and refuses to assign a tier. NA never collapses to a fake Normal.
The tier model. Four tiers cut on rawRank (P25, P50, P75) with asymmetric hysteresis: 1 confirmed bar to step up (so a vol breakout is not missed), 3 confirmed bars to step down (so a tier change only confirms when vol has actually died). The ribbon fill and oscillator line both color by tier. Extreme is a signal class, not a tier; it would flicker on and off at the P90 boundary if we colored the ribbon by it.
The phase model. Four phases (Rising / Topping / Falling / Bottoming) read off the rawRank slope. Slow rotations need 2 bars of confirmation to flip; violent moves with |delta rank| > 15 bypass the confirm and flip immediately. Peak and trough detection is plateau-aware: a strict ( greater-than on both sides) check missed the patterns where ATR percentile pins at 100 for multiple bars, so the algorithm uses greater-or-equal on the left side and greater-than on the right.
The events. Three signature events, each with its own gating:
Compression Release : velocity-gated. The Compression tier must run at least 10 bars to load the spring; on exit, rawRank must reach the mid (>= 50) within a 5-bar window. Slow leaks that drift through Quiet for more than 5 bars are canceled. Re-entering Compression also cancels the pending episode.
Extreme Touch : rawRank peaks at >= 90. Re-arm runs through a three-valve cascade (rank drop to <= 75, a higher pivot with a +2 rank headroom so a 98 peak after a 97 cannot re-fire, or 2x lookback time decay) so the same Extreme arc cannot duplicate-fire, but a genuinely higher pivot in the same arc still counts.
Cooling : armed when an Extreme fires; fires on the first confirmed bar after where rawRank falls below 75 within a 10-bar window. Disarms on fire or when the window expires. The armed-latch architecture means fast drops out of an Extreme are tracked after the Extreme event arms Cooling, instead of relying on a single fragile cross check that would miss the drop if the threshold was already crossed on the Extreme bar itself.
The Playbook Lens. Pure interpretation layer. Engine, percentile, tier, phase, and objective events are identical across lenses. The Lens recolors three visual surfaces only: the panel Playbook row text and tone, the Playbook Heatmap Strip at y = -5, and an optional Tint Price Candles by Playbook Fit overlay. Switching the Lens dropdown answers a different question against the same volatility truth: "does this regime align with the workflow I am running?" - context, never a directive.
════════════════════════════════════════════
◈ HOW TO READ IT
The pane shows the smoothed percentile rank line wrapped in a tier-colored ribbon with a Volatility Glow halo that breathes wider in the loaded zones (Compression and Extreme) and tightens in Normal. Threshold lines mark P25, P50, P75, and P90.
Deep blue (Compression): rawRank in [0, 25). Loaded spring.
Light blue (Quiet): rawRank in [25, 50). Below median, not stretched.
Gray (Normal): rawRank in [50, 75). Typical bar ranges.
Orange (Elevated): rawRank in . High vol relative to recent history.
Red (Extreme): event color, not a tier. Drives Extreme Touch markers.
Teal (Release): event color, not a tier. Drives Compression Release markers.
Markers, in order of conviction:
Compression Release (diamond on the line, Release color, with a matching pane background pulse): a >= 10 bar compression run resolved into Normal+ within 5 bars. Non-directional by design - a volatility state change, not a price direction call.
Extreme Touch (small circle anchored to the actual peak bar, Extreme color): rawRank just peaked at or above the 90th percentile of its rolling history. Reads as topping pressure of vol, not a directional reversal call.
Cooling (panel-only event, no chart marker): the first confirmed bar after an Extreme where rawRank fell back below 75 within a 10-bar window. Surfaces in the Last Event row and the Cooling alert.
The info panel synthesizes six rows: Volatility (tier + P-Score), Flow (phase), Age (bars in tier + the per-tier duration percentile so a 200-bar Quiet stretch is compared against historical Quiet stretches, not Elevated), Last Event / Context (state-based decay, no fixed timer), ATR Range (current bar range as % of price, with absolute price-unit ATR in the row tooltip), and Playbook (the Lens context read).
The Last Event row uses state-based decay , not an arbitrary 10-bar timer. A Compression Release stays visible while phase is Rising or tier is Normal+. An Extreme Touch stays visible while tier is Elevated. A Cooling read stays visible while tier is Normal or Elevated. When the event's regime context expires, the row returns to Context and summarizes the current regime instead of resizing or disappearing.
════════════════════════════════════════════
✦ HOW WE USE IT: THE COILED-SPRING ARC
This is the arc the indicator is built to catch - not the only path. Many compressions resolve sideways without a confirmed release, and the velocity gate is what filters those out.
A common pattern on a liquid index or crypto chart, Swing profile (default), Neutral lens: the line drops into Compression and parks there for 15-30 bars. The ribbon turns deep blue, the Glow widens, and the panel Age row may read something like "Mature · 22 bars" or "Extended · 22 bars" - meaning the current run has already lasted longer than most recent Compression stretches on this market. The spring is loaded.
The full arc reads in four panel updates:
Release. rawRank reaches 50+ within the 5-bar velocity window after exiting Compression. A Release diamond prints on the line, the pane background pulses teal for one bar, and the Last Event row reads "Compression Release".
Run. Within a few bars the tier transitions through Normal into Elevated, the phase row flips Rising, and the smoothed line climbs toward the upper distribution.
Touch. If the move keeps loading, rawRank peaks at 92-98 and an Extreme Touch circle prints on the peak bar - the smoothed line is now in the upper edge of its own rolling distribution. The Last Event row updates to "Extreme Touch".
Unwind. Within 10 bars rawRank falls below 75. Cooling fires and the Last Event row updates again.
The Playbook Lens reframes the same arc without changing a number. Flip to Breakout: the Heatmap Strip lights teal during the release window (favorable) and dims toward red as the move stretches into Extreme (less favorable). Flip to Mean Reversion: the strip stays red through the release (vol is the wrong direction for fading) and only lights teal when Cooling confirms and tier drifts back through Normal toward Quiet. Flip to Risk Control: Compression marks calmer bar-range context, Elevated and Extreme mark the wider-bar context. Same volatility truth, different playbook fit. The engine is identical across lenses; only the interpretation layer changes.
════════════════════════════════════════════
✦ OTHER APPLICATIONS
Breakout context : Compression Release diamonds after a loaded quiet regime, optionally combined with the Heatmap Strip reading favorable under the Breakout lens
Trend context : Rising Elevated or Rising Normal volatility as movement context for an external trend plan
Mean-reversion context : quieter or cooling regimes that may be more suitable for contained-range workflows
Volatility risk overlay : Elevated and Extreme states as wider-bar context when reviewing size, stops, or trade frequency
Vol regime classifier : use the Volatility row + Flow row in the panel as a top-down filter for any external trade plan, independent of the Lens
Alert-driven workflow : subscribe to Compression Release + Extreme Touch + Cooling and check the chart only when the volatility regime actually changes, not every bar
════════════════════════════════════════════
⚙ GETTING STARTED
ATR Volatility Regime ships with three pre-tuned Horizon profiles plus a Custom override. Pick a horizon and start reading the regime:
Intraday : ATR 14, lookback 100, smoothing 3. Faster events, lighter hysteresis (1 up / 2 down). Use on 1m through 1H charts.
Swing (default) : ATR 14, lookback 200, smoothing 5. Balanced. Start here on 1H through 1D charts.
Long-Term Hold : ATR 20, lookback 300, smoothing 5. Slower, rarer events, heavier hysteresis (2 up / 3 down). Use on 1D and above.
Custom : full manual control of ATR Period, Lookback Window, and Smoothing.
Core settings:
Horizon : selects the tuning bundle above. Start with Swing.
ATR Period (Custom) : Wilder ATR period for the volatility input, in BARS. 14 is the standard. Shorter = more reactive; longer = smoother. Applies only when Horizon = Custom.
Lookback Window (Custom) : rolling lookback the ATR% is percentile-ranked against. Larger = smoother distribution, fewer extreme reads, slower compression releases. Smaller = sharper, more events.
Smoothing (EMA) (Custom) : EMA bars applied to the percentile-rank for the visual DISPLAY layer (plot, ribbon, panel readouts). The RAW rank still drives tier, phase, and events - smoothing only calms the visual. Set to 1 to disable smoothing.
Playbook Lens:
Neutral (default) : factual regime read, heatmap stays gray. Use this to learn the engine.
Breakout : range-expansion context. Loaded Compression and Compression Release read favorable; already-stretched Elevated or Extreme states shift toward caution.
Trend : directional-movement context. Rising Elevated and Rising Normal regimes read favorable; topping or cooling volatility shifts toward caution.
Mean Reversion : contained-range context. Quiet, Cooling, and Normal/Falling regimes read favorable; Release, Elevated, and Extreme regimes shift toward caution.
Risk Control : stretched-volatility context. Compression reads calm; Elevated and Extreme states warn that bar ranges are wide.
The Lens NEVER changes the engine - same tier, same phase, same Compression Release, same Extreme Touch, same alerts. Only the panel Playbook row text, the Heatmap Strip color, and the optional candle tint move.
Display:
Show Compression Releases (hero): diamond on the line + pane background pulse on release. On by default.
Show Extreme Touches : circle on the peak bar at rawRank >= 90. On by default.
Show Price Chart Markers : mirrors Compression Release diamonds and Extreme bar tints onto the price chart. OFF by default to keep the price chart clean.
Show Raw Rank Line : faint unsmoothed percentile rank line behind the smoothed display line. OFF by default. Toggle on to debug fast vol changes.
Show Volatility Glow : halo that widens at the loaded extremes (Compression and Extreme) and tightens in Normal. On by default.
Show Info Panel : 6-row state panel. On by default.
Panel Position : Top Right (default), Top Left, Bottom Right, Bottom Left, Middle Right.
Theme : Auto (detect chart background), Dark, or Light.
Show Playbook Heatmap Strip : thick band at y = -5 that recolors with the Lens. On by default.
Tint Price Candles by Playbook Fit : paints price-chart candles with the Release / Extreme palette per the active Lens. OFF by default; disabled automatically when Lens = Neutral.
Appearance / Palette (6 color pickers):
Compression, Quiet, Normal, Elevated, Extreme, Release - each on its own line with a state-explainer tooltip. The Display Rank line, Raw Rank, Tier Ribbon fill, Volatility Glow, Heatmap Strip, panel tier text, candle tints, and event markers all reference these inputs so users can adapt the palette (color-blind, light-mode, brand themes) without forking the script.
════════════════════════════════════════════
△ LIMITATIONS
Warm-up : the lookback window must fill before any tier is assigned. On Swing (200) that is 200 bars; on Long-Term Hold (300) that is 300. Until then, the panel shows "Warming up" and the state engine refuses to fake a Normal read.
Visual smoothing lag : the visible line is intentionally calmer than the raw engine. ATR is a backward-looking Wilder-smoothed measure, and the display line is lightly EMA-smoothed on top, so fast volatility expansions can look slightly delayed in the visible plot. The rawRank engine is the sharper layer underneath and is what actually drives the tier, phase, events, and alerts. The smoothed line is the readable copy; do not read a slight visual delay as the event engine being slow.
Percentile is relative, not absolute : a "Compression" read on a chronically quiet asset can still be wider than an "Elevated" read on a chronically loud asset. The indicator compares each asset against ITS OWN history, not across markets.
Regime shifts shrink the window : a structural vol regime change (e.g. a quiet 2-year period followed by a sustained higher-vol regime) takes about one lookback window to fully recalibrate. The first few weeks after a regime shift can read noisier than the steady-state.
Compression Release is non-directional : the diamond and the pane pulse tell you the spring released, not which way price went. Combine with directional context (trend, structure, or a separate momentum tool) for direction.
Extreme Touch is a state read, not a reversal call : rawRank pinning above 90 means vol is rare for this market; it does not mean price is about to reverse. Cooling tells you the unwind has begun, not where the next leg goes.
Playbook Lens is interpretation, not validation : the Heatmap Strip recolors regime context based on the active Lens. It is not a backtested edge - it is a quick visual answer to "does my workflow want this regime?"
════════════════════════════════════════════
🔔 ALERTS
Four alert conditions are built in so you can monitor without checking every bar manually:
Compression Release : a sustained compression (>= 10 bars) confirmed above mid-rank within 5 bars. The hero event.
Extreme Touch : rawRank peaked above P90. Fires on the bar after the actual peak (peak detection requires the next bar to confirm the turn-down).
Cooling : the first confirmed bar after an Extreme where rawRank falls below 75 within 10 bars.
Compression Entry : rawRank dropped below P25 (sustained tier transition into Compression).
All four alerts fire on bar close (gated on barstate.isconfirmed). Each alert message is a pure JSON payload with ticker, price, timeframe, and timestamp fields for webhook routing.
Four alerts by design - concentrated on the signature events. Tier and phase transitions stay visible in the info panel for users who want them on the chart, but they do not fire alerts. Keeping the alert stream lean is what makes "subscribe and let the regime come to you" a useful workflow instead of a notification flood.
════════════════════════════════════════════
⌁ NOTES
Based on the classical ATR percentile-rank construction, with asymmetric hysteresis and a velocity-gated compression-release definition layered on top.
Repaint: intrabar-only. Closed-bar alerts are confirmed; current-bar visuals may update until the bar closes. All alert conditions are gated on barstate.isconfirmed. Peak-confirmed events (Extreme Touch) print on the bar AFTER the actual peak, on a one-bar offset, so the marker aligns with the true peak bar.
References: J. Welles Wilder Jr., New Concepts in Technical Trading Systems (1978), Trend Research; percentile-rank concept widely used across volatility studies.
Open-source under MPL 2.0. Free to use, fork, study.
NovaLens Indicator
Indicator
Indicator
Concordance Execution Mandate [JOAT]Concordance Execution Mandate
Introduction
Concordance Execution Mandate is an open-source PulseWire strategy that integrates the indicator concepts used throughout the JOAT Suite into one execution framework. It combines crossframe bias, auction location, stepped structure, momentum timing, absorption participation, and volatility gating before any trade is allowed. It also renders on-chart trade rails, stop placement, profit targets, and a dashboard summarizing the active execution state.
The purpose of the strategy is not to optimize one narrow market condition. The purpose is to require multiple independent conditions to agree before a trade is taken. This reduces single-factor noise and creates a more realistic execution process than a strategy that relies on only one oscillator or one moving-average crossover.
Core Concepts
1. Crossframe Regime Filter
Higher-timeframe trend alignment establishes the directional permission layer. If the dominant bias is not aligned, the strategy remains filtered.
2. Auction Location Filter
Price must also be in a constructive value location for longs or a defensive value location for shorts. This reduces cases where a trend is positive but price is poorly located relative to accepted value.
3. Structure and Momentum Gate
The local stepped structure and momentum score must agree with the higher-level direction before a trade is permitted.
4. Absorption and Volatility Filter
If an active absorption range exists, the strategy uses it as a participation filter. Volatility percentile and directional volatility behavior are also used to avoid unsuitable states.
5. ATR-Based Risk Management
Stops are sized from ATR and, when enabled, can anchor to structural references. Targets are placed using configurable R multiples.
Features
Multi-layer trade permission: Crossframe, auction, structure, momentum, absorption, and volatility must align
Confirmed-bar logic: Entry conditions are evaluated on confirmed bars
ATR-based stop logic: Risk is normalized to current market conditions
Two staged exits: TP1 and TP2 are placed automatically, with a third informational rail on-chart
On-chart trade rails: Entry, stop, TP1, TP2, and TP3 are drawn directly on the chart
Risk/reward fills: Visual fill between entry and stop or target levels
Execution dashboard: Displays regime, permission, auction state, structure state, momentum, absorption, ATR percentile, position state, and active risk rail
Realistic default properties: Uses commission, slippage, and percent-of-equity sizing
Strategy Properties Used By Default
Initial Capital: 100000
Commission Type: Percent
Commission Value: 0.05
Slippage: 2
Pyramiding: 0
Position Size: 10% of equity
Orders Processed On Close: Enabled
How to Use This Strategy
Step 1: Read the dashboard before evaluating the backtest. The strategy is built around permission states, not constant market participation.
Step 2: Check whether the system is in Long Bias, Short Bias, or Mixed mode.
Step 3: Observe whether the strategy is filtering trades because one of the major layers is missing, such as auction location or volatility suitability.
Step 4: Use the on-chart rails to understand how the strategy is defining risk and reward at each entry.
Strategy Limitations
Like all strategies, results depend on market, timeframe, and input choices
Higher-timeframe filters are intentionally delayed for non-repainting safety
Multiple filters can reduce trade frequency substantially
The strategy is designed as a robust execution framework, not as a guarantee of profitability
Backtest results should be interpreted with realistic skepticism and proper context
Originality Statement
Concordance Execution Mandate is original in the way it integrates top-down bias, auction location, local structure, momentum timing, participation filtering, and volatility gating into one execution process with visible trade management rails. The script is published to show how multiple institutional-style context layers can be fused into a realistic open-source framework.
Disclaimer
This strategy is provided for educational and informational purposes only. It is not financial advice or a recommendation to trade any market. Backtest results are based on historical data and do not guarantee future performance. All trading involves risk, including the risk of loss. Use independent judgment and proper risk management.
-Made with passion by jackofalltrades
Strategy
Adaptive Flow II | AnonycryptousAdaptive Flow II | Anonycryptous
Description & user manual
Why this indicator is different
Most trend-following indicators use a fixed moving average. A 50-period EMA moves at the same speed whether the market is trending hard or grinding sideways. It cannot distinguish between a clean directional move and noise. It gives the same weight to a volatile consolidation as it does to a strong impulse. The result is signals that arrive late in trends and fire repeatedly during chop.
Adaptive Flow v2 works differently.
At its core is a Kaufman Adaptive Moving Average — a moving average that measures the efficiency of price movement on every single bar and adjusts its own speed accordingly. When price is moving cleanly in one direction with low noise, the flow line accelerates toward price. When price is churning sideways with high volatility and no direction, the flow line nearly stops moving. It adapts. Automatically. Without requiring any manual intervention.
V2 builds significantly on this foundation. It adds five configurable stop modes, full market structure detection through BOS and CHoCH events, three independent signal filters, dynamic extension bands, a session-anchored VWAP, and an expanded dashboard. The result is a complete adaptive trend and structure system — not just a trend indicator, but a context-aware trading framework.
Important notice
Adaptive Flow v2 generates signals based on technical indicator alignment.
These signals are not financial advice.
They do not predict the future.
They do not guarantee profitability.
All trading decisions are made entirely by the user.
Always manage your own risk. Always apply your own judgment.
1. Overview
Adaptive Flow v2 is an adaptive trend-following indicator built around a Kaufman Adaptive Moving Average with a configurable stop engine and full market structure detection.
What it includes:
- Kaufman Adaptive Moving Average rendered as a neon glow line with four stacked plot layers
- Five stop modes: ATR Trailing, Supertrend, Chandelier, Donchian, and Volatility Pivot
- Cloud fill between the flow line and the stop line, reflecting the current trend state
- Dynamic extension bands above and below the flow line at configurable ATR distance
- BOS and CHoCH structure detection with BOS confirmation filter
- Pivot high and low target lines that change color when broken
- EMA 200 macro trend filter with higher timeframe support
- ADX filter for directional environment confirmation
- Session filter to restrict signals to a configurable trading window
- Signal cooldown to prevent repeated triggering
- Session-anchored VWAP with daily and custom session modes
- Bar coloring reflecting the current trend state
- Three presets: default, fast, and smooth
- Live dashboard with 13 data rows
- Seven alert conditions
2. The flow line — Kaufman Adaptive Moving Average
The flow line is the visual heart of Adaptive Flow. On every bar it calculates an Efficiency Ratio — a measure of how directionally efficient price movement is relative to total volatility over the lookback period.
When the Efficiency Ratio is high — price is moving strongly in one direction with low noise — the flow line accelerates toward price. When the Efficiency Ratio is low — price is ranging with high volatility — the flow line nearly stops moving.
This adaptive behavior means the flow line naturally stays close to price during strong trends and pulls away only during genuine transitions. It is not a lagging average that mechanically follows price at a fixed delay. It responds to market character.
The flow line is rendered with four stacked plot layers — a sharp core at full opacity and three progressively wider, more transparent layers behind it — creating a neon glow effect that makes it visually distinct on any chart.
The noise filter adds an additional gate: KAMA only advances when the price displacement exceeds ATR × threshold. This prevents the flow line from reacting to insignificant micro-movements during low-momentum conditions. Disable it for maximum responsiveness in strong trending environments.
3. Stop engine — five modes
The stop engine calculates a dynamic stop level from the flow line. All five modes use the flow line as their reference point, not raw price. This means the stop inherits KAMA's adaptive smoothing before calculating any distance.
When the flow line crosses the stop level, the trend flips and a signal fires.
3.1 ATR Trailing (default)
The stop trails the flow line at a fixed ATR distance using a ratchet mechanism — it only moves in the direction of the trend and locks in the floor or ceiling. This produces the characteristic smooth, flowing wave that follows the flow line closely. The cloud between the flow line and the stop gives a live view of the trend zone width. Default and recommended for most users.
3.2 Supertrend
ATR band above or below the flow line with ratchet mechanism. Similar to ATR Trailing but calculated differently, producing a more angular step-like stop line. More angular appearance, fewer intermediate flips.
3.3 Chandelier
The stop trails the highest or lowest flow line value over a configurable lookback window, then subtracts or adds ATR × multiplier. Exits when the flow line has sustained a reversal beyond the lookback range. Better for trending markets where you want to trail a historical extreme rather than the current level.
3.4 Donchian
The stop follows the highest or lowest flow line value over a rolling window with no ATR component. Purely range-based. The stop level is exactly the rolling high or low of the flow line — clean, simple, no volatility scaling.
3.5 Volatility Pivot
The stop anchors to the last confirmed pivot high or low of the flow line plus an ATR buffer. Structurally aware — the stop sits at a level where the flow line previously reversed, not at an arbitrary distance. Best for traders who want the stop to respect structure rather than trail at a fixed distance.
4. Extension bands
When enabled, two bands are drawn above and below the flow line at ATR × multiplier distance. They are not stop levels — they are extension context. When price reaches the upper band during a bullish trend, it may indicate an overextended condition. When price compresses back toward the flow line after touching a band, it may indicate a pullback area. The bands move with the flow line and adapt to current volatility.
5. Market structure — BOS and CHoCH
Adaptive Flow v2 includes a full market structure detection engine that runs alongside the adaptive trend engine.
Pivot highs and lows are detected on price using configurable left and right bar lookbacks. When price closes beyond a confirmed swing level, the indicator classifies the event as either a Break of Structure or a Change of Character.
A BOS fires when price closes beyond a swing level in the direction of the existing structural trend — confirming continuation. Drawn as a dashed line
A CHoCH fires when price closes beyond a swing level against the existing structural trend — signaling a potential reversal. Drawn as a solid line.
The BOS confirmation requirement prevents false reversals. When set to 1 (default), at least one BOS must confirm the current structural trend before a CHoCH can flip it. This blocks the common false reversal where a sharp pullback briefly closes beyond a swing level before the trend reasserts.
Pivot target lines are drawn automatically at the last confirmed pivot high and low. They extend to the right and change color when price closes through them.
6. Signal filters
Three optional filters are available. All three can be combined. A signal only fires when all active filters agree.
EMA 200 — always active as a macro filter. Bullish signals only fire above the EMA 200. Bearish signals only below. Set the EMA 200 timeframe to a higher timeframe (1H or 4H) when trading on lower timeframes — the native EMA 200 on a 1-minute chart only covers a few hours and provides no meaningful macro context.
ADX filter — when enabled, signals only fire when ADX is at or above the configured threshold. Below this level the market is typically ranging and directional signals carry less weight. Default threshold of 20 removes the weakest trend environments.
Session filter — when enabled, signals only fire during the configured trading window. Defined in HHMM-HHMM format using exchange timezone. Outside the window the flow line continues calculating but no new signals are generated.
Signal cooldown — minimum bars between two signals in the same direction. Prevents repeated triggering during choppy conditions around the stop level.
7. VWAP
The VWAP provides a volume-weighted price reference that resets at the start of each session. It represents the average price paid weighted by volume — a key reference for intraday value and institutional order flow.
Daily mode resets every calendar day. Custom mode anchors to a specific session defined by start and end times in HHMM-HHMM format. Timezone selection ensures correct boundary alignment.
8. Presets
Three preset configurations are available. Selecting a preset overrides the core KAMA calculation parameters.
Default — balanced for swing trading on 4H and daily charts.
Adaptive length 14 | Fast constant 2 | Slow constant 30 | Noise threshold 0.3.
Fast — built for scalping on 1 to 15 minute charts.
Adaptive length 6 | Fast constant 2 | Slow constant 15 | Noise threshold 0.15.
Shorter lookback for faster momentum shift detection. Lower noise threshold preserves full adaptive speed.
Smooth — designed for position trading on daily and weekly charts.
Adaptive length 21 | Fast constant 3 | Slow constant 40 | Noise threshold 0.5.
Extended lookback demands sustained momentum before accelerating. Aggressive noise filtering for high-conviction reads only.
9. Dashboard
The dashboard displays the live state of all indicator components and updates on every bar.
Rows displayed:
- Adaptive Flow — indicator name with trend-colored header and current timeframe
- Trend — current flow line direction: bullish or bearish
- Stop Mode — active stop mode in use
- Structure — current structural direction from BOS/CHoCH logic
- EMA 200 — whether price is above or below the macro filter
- VWAP — whether price is above or below session value
- ADX — current ADX value with confirmation indicator
- Session — whether the session filter is active and the current bar is inside the window
- Noise Filter — whether the noise gate is active
- Stop Distance — distance from current close to stop level in ATR multiples and as a percentage
- Trend Bars — number of bars the current trend has been active
- BOS Count — number of confirmed BOS events in the current structural direction
- Signal — last signal fired: buy, sell, CHoCH, BOS, or none
10. Settings reference
KAMA & Calculation
- Price Source: input for the flow line calculation
- Adaptive Length: efficiency ratio lookback period
- Fast Constant: smoothing speed during trending conditions
- Slow Constant: smoothing speed during ranging conditions
- Enable Noise Filter: toggle the displacement gate
- Noise Threshold: minimum ATR multiple required to advance the flow line
- Preset: Default, Fast, or Smooth
Stop Engine
- Stop Mode: ATR Trailing, Supertrend, Chandelier, Donchian, or Volatility Pivot
- ATR Length: volatility measurement period
- ATR Multiplier: distance scaling for the stop level
- Stop Lookback: rolling window for Chandelier and Donchian modes
- Pivot Buffer: ATR buffer for Volatility Pivot mode
Market Structure
- Show BOS / CHoCH: toggle structure detection
- Pivot Left / Right Bars: swing confirmation lookback
- Max Structure Levels: maximum lines shown on chart
- BOS Required Before CHoCH Flip: false reversal filter
- Show Pivot Target Lines: toggle automatic target lines
- Target Line Color and Width
Signal Filters
- EMA 200 Timeframe: leave empty for chart timeframe
- Show EMA 200: toggle line and label visibility
- EMA 200 Color
- Enable ADX Filter: toggle directional environment gate
- ADX Length and Threshold
- Enable Session Filter: toggle session-based signal restriction
- Session Window: HHMM-HHMM format
- Signal Cooldown: bars between signals
VWAP
- Session: Daily or Custom
- Timezone: UTC, Exchange, or major financial center timezone
- Session Window: for Custom mode
- Show VWAP: toggle line and label
- VWAP Color
Visuals
- Bull Color and Bear Color
- Cloud Transparency: fill between flow line and stop
- Show Extension Bands: toggle ATR extension bands
- Extension Band Multiplier: distance from flow line
- Show Reversal Signals: toggle triangle markers
- Color Candles: toggle bar coloring
- Candle Transparency
Dashboard
- Show Dashboard
- Size: Tiny, Small, or Normal
- Position: Top Left, Top Right, Bottom Left, or Bottom Right
11. How to use
11.1 Initial setup
Select a preset matching your primary trading style. Set the EMA 200 timeframe to a higher timeframe when trading on lower timeframes — 60 for 1H, 240 for 4H. Set the VWAP to Daily or configure a custom session matching your primary market. Choose a stop mode — ATR Trailing is the default and works well across all timeframes. Enable the session filter and ADX filter if you want stricter signal conditions.
11.2 Reading the chart
The flow line and its glow indicate the current adaptive trend. Green indicates a bullish environment. Red indicates a bearish environment. The cloud between the flow line and the stop shows the trend zone width — a wide cloud indicates strong momentum, a narrowing cloud indicates the flow line is slowing.
The stop line is where the trend flips. A reversal signal fires when the flow line crosses it. Triangle markers appear at the stop line at the signal bar.
Extension bands show how far price has moved from adaptive value. Price at the upper band in a bullish trend may indicate overextension. Price returning toward the flow line after touching a band may offer a pullback reference.
BOS and CHoCH lines show structural context. Use them to understand whether the trend is in a confirmation phase (BOS firing repeatedly) or approaching a potential reversal (flow line slowing while price approaches a structural level).
11.3 Timeframe guide
1 to 5 minutes — Fast preset. EMA 200 timeframe set to 60 or 240. Session filter recommended.
15 to 30 minutes — Fast or Default preset. EMA 200 timeframe 240 or D.
1 hour to 4 hours — Default preset. Native EMA 200 or D timeframe.
Daily and above — Smooth preset. Native EMA 200.
11.4 Stop mode selection guide
ATR Trailing — best for most situations. Smooth, flowing, closely follows the flow line.
Supertrend — fewer flips, more angular. Good for lower timeframe noise reduction.
Chandelier — suited for trending markets where you want to trail a recent high or low.
Donchian — clean range-based stop with no ATR influence. Simple and transparent.
Volatility Pivot — best when you want the stop at a structurally meaningful KAMA level.
11.5 Context
Adaptive Flow v2 identifies adaptive trend direction and market structure. It does not filter by fundamental events, news, or macro calendar. A bullish signal during a risk-off macro event may fail more often than one in a clear trending environment. Always apply your own context and judgment alongside the indicator output.
12. Alerts
Seven alert conditions are available:
- Bull Trend: flow line crosses above the stop level, EMA 200 above, all active filters passed.
- Bear Trend: flow line crosses below the stop level, EMA 200 below, all active filters passed.
- Any Trend Change: fires on either bull or bear trend signal.
- Bull CHoCH: market structure flips to bullish via Change of Character.
- Bear CHoCH: market structure flips to bearish via Change of Character.
- Bull BOS: bullish Break of Structure confirms trend continuation.
- Bear BOS: bearish Break of Structure confirms trend continuation.
All alerts include exchange, ticker, and interval in the message.
13. Disclaimer
This indicator is provided for educational and informational purposes only.
All outputs are based on historical price action calculations and do not guarantee future results.
Trading financial instruments involves significant risk of loss.
Past performance does not indicate future results.
Use at your own discretion.
Indicator
Indicator
Liquidity-Anchored Trailing Stop [BigBeluga]Liquidity-Anchored Trailing Stop is a comprehensive volatility and structural framework designed to provide a protective "heatmap" around price action. By fusing multi-layered ATR-based trailing logic with a dynamic Volume Profile, this indicator identifies where market momentum is accelerating and where institutional liquidity is "anchored."
Instead of a single line, this tool provides a graded risk-mitigation zone that adapts to market noise, ensuring you remain in the trend during healthy pullbacks while identifying the exact structural peaks where volume was most concentrated.
🔵 THE DUAL-ENGINE FRAMEWORK
Volatility Heatmap (Trailing Stop): The indicator calculates four distinct levels of trailing protection (Stop 1 through Stop 4). These are anchored to the trend’s direction and volatility, creating a "safety buffer" that narrows or expands based on the Average True Range (ATR).
Trend-Relative Volume Profile (Right Side): Unlike static volume profiles, this engine focuses specifically on the current trend segment. It visualizes the total relative volume transacted at each price bin since the last trend flip, highlighting where the real "meat" of the move occurred.
High Volume Nodes (HVNs): The script automatically detects peaks in the volume distribution. These High Volume Nodes represent structural anchors where the market has spent significant time, serving as high-probability zones for support or resistance.
🔵 CORE ARCHITECTURE
Liquidity Anchoring: By plotting HVN levels (Structural Peaks), the indicator shows you exactly where liquidity is sitting. When a trailing stop aligns with a volume peak, it creates a "Hard Anchor"—a level that is significantly harder for price to break through.
Adaptive Stop Logic: The trailing stops (ts1-ts4) use a ratchet mechanism. In an uptrend, the stops only move up; in a downtrend, they only move down. This prevents the "stop-loss creep" that often leads to giving back profits.
Dynamic Gradient Heatmap: The space between the four trailing bands is filled with a color-coded gradient. Saturated colors represent the core trend, while the outer bands represent the "exhaustion zone" where the trend is at risk of structural failure.
🔵 FEATURES
Granular Profile Rows: Fully adjustable vertical resolution (Profile Rows) allows you to define how detailed you want the volume distribution to be, ranging from broad structural areas to precise price levels.
Peak Level Detection: Horizontal structural lines are automatically drawn across the trend range at major HVNs, providing immediate visual targets and pivot points.
Smart Trend Labels: Clean UI labels (Bull/Bear) mark the exact bar where the trend flips and the volatility bands reset, ensuring you never miss a shift in market regime.
Visual Clarity Toggle: Includes options to show or hide the Volume Profile and Peak Levels, allowing you to use the tool as a pure volatility stop or a full-scale market structure map.
🔵 STRATEGIC APPLICATION
Trailing with the Heatmap: Use the innermost band (Stop 1) for aggressive scalping or tight management, and the outermost band (Stop 4) for macro trend following. If price closes beyond Stop 4, the trend is officially considered "broken."
HVN Confluence: Look for instances where the Trailing Stop aligns with a High Volume Node. These "Anchored Stops" are the most robust areas to place your actual exchange orders, as they are backed by both volatility and historical volume.
Volatility Breakouts: When the ATR bands (Heatmap) contract significantly and then price breaks out, look to the Volume Profile to see if the breakout is supported by a surge in volume at the new price bins.
Targeting Structural Peaks: In a trending market, use the volume peaks on the right side of the chart as natural take-profit targets or areas to expect temporary price stalls.
Liquidity-Anchored Trailing Stop transforms traditional stop-loss logic into a multi-dimensional map of risk and liquidity. By understanding where volume is anchored and how volatility is breathing, you can stay in winning trades longer and exit with precision when the structure finally fails. Indicator
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
Indicator
Volatility Gated Supertrend [BackQuant]Volatility Gated Supertrend
Overview
Volatility Gated Supertrend is a regime-aware trend-following indicator built around a modified Supertrend engine with an integrated volatility filter . Unlike a traditional Supertrend, which flips direction whenever price crosses its trailing bands, this version introduces a gating mechanism that can block trend reversals during low-volatility conditions .
The purpose of the indicator is simple:
Keep the responsiveness and structure of a Supertrend.
Reduce false flips during sideways or compressed conditions.
Allow trend transitions primarily when volatility is expanding enough to justify participation.
The result is a smoother and more selective trend engine designed to suppress whipsaws while still reacting to meaningful directional movement.
The full source structure for the indicator can be referenced here: :contentReference {index=0}
Core idea
Traditional Supertrend indicators work well during directional markets but struggle in compressed environments:
Price repeatedly crosses the trailing bands.
Trend direction flips too frequently.
False reversals appear during chop.
This indicator attempts to solve that problem by asking:
“Is there enough volatility expansion to justify accepting a new trend?”
Instead of blindly allowing every flip, the indicator measures:
Current volatility,
Baseline volatility,
Relative expansion or compression.
Only when volatility conditions are sufficient does the trend engine allow a directional transition.
What the Supertrend is
The Supertrend is a volatility-based trailing trend indicator built from:
ATR (Average True Range)
A central price source
A directional trailing stop structure
The classic logic:
Upper band = price source + ATR × multiplier
Lower band = price source − ATR × multiplier
These bands trail price dynamically:
In bullish conditions, the lower band ratchets upward.
In bearish conditions, the upper band ratchets downward.
When price crosses one of the bands:
The trend flips direction.
This creates a clean directional regime model.
How this version differs
The major difference is the volatility gate .
A normal Supertrend asks:
“Did price cross the band?”
This indicator asks:
“Did price cross the band, and is volatility strong enough to trust the move?”
That additional filter dramatically changes behavior in sideways conditions.
ATR and volatility structure
The indicator uses two ATR measurements:
Fast ATR → current short-term volatility
Slow ATR → baseline long-term volatility
The core ratio:
Volatility Ratio = Fast ATR / Slow ATR
Interpretation:
Ratio above threshold → volatility expansion
Ratio below threshold → volatility compression
This becomes the gate logic.
Volatility Gate Logic
The gate opens only when:
Fast ATR / Slow ATR ≥ Gate Threshold
If volatility is too compressed:
The gate closes.
Trend flips are blocked.
Importantly:
The Supertrend bands still calculate normally.
Price can still cross them.
But the directional state will not update while the gate is closed.
This distinction matters because it means:
The market may technically trigger a reversal,
But the indicator intentionally ignores it if volatility conditions are weak.
Why this helps
Most trend-following systems fail in chop because:
Small meaningless moves trigger directional flips.
There is insufficient range expansion.
The market lacks trend persistence.
By requiring volatility confirmation:
Weak reversals are filtered out.
Trend state becomes more stable.
Noise is reduced.
This makes the indicator particularly useful during:
Low-volatility consolidations,
Mean-reverting conditions,
Slow drifting ranges.
Band construction
The indicator uses:
hl2 as the central source,
ATR for dynamic width,
A configurable multiplier for sensitivity.
Formulas:
Upper Band = hl2 + ATR × multiplier
Lower Band = hl2 − ATR × multiplier
The trailing logic prevents the bands from moving backward unnecessarily:
Bullish lower band only rises.
Bearish upper band only falls.
This creates the staircase-style trailing structure common in Supertrend systems.
Trend state
Trend direction is binary:
1 = bullish
-1 = bearish
A raw bullish flip occurs when:
Close > trailing upper band
A raw bearish flip occurs when:
Close < trailing lower band
However:
The trend only updates if the volatility gate is open.
This is the defining behavior of the script.
Blocked flips
One of the most important features is the visualization of blocked signals .
When:
Price crosses a band,
But volatility is insufficient,
The script:
Plots an X-cross marker,
Keeps the existing trend state,
Refuses the flip.
This gives traders visibility into:
Potential but unconfirmed reversals,
Areas of weak participation,
Fake breakouts or low-energy transitions.
Visual behavior
Trend band
The active trailing band changes color based on trend direction:
Bullish → bullish color
Bearish → bearish color
Gate closed → gated color (dimmed)
Trend fill
The script fills the space between price and the active band:
Bullish fill during bullish regimes
Bearish fill during bearish regimes
This creates a cleaner directional overlay.
Outer glow
An additional glow layer expands slightly beyond the trend band:
Adds directional emphasis,
Improves trend readability,
Visually reinforces active regime.
When the gate closes:
The band and candles dim.
This visually communicates:
“The trend engine is currently suppressing flips.”
Candle coloring
Candles can optionally inherit the trend state:
Bullish regime → bullish candles
Bearish regime → bearish candles
Gate closed → dimmed neutral appearance
This allows the indicator to function as a full-chart regime overlay.
Signal logic
Bullish signal
Occurs when:
Trend flips from bearish to bullish,
AND the gate is open.
Bearish signal
Occurs when:
Trend flips from bullish to bearish,
AND the gate is open.
Blocked signal
Occurs when:
A raw flip condition appears,
BUT volatility ratio is below threshold.
This distinction is important:
A blocked signal is not ignored information.
It is a rejected transition.
How to interpret the gate
Gate open
Volatility is active.
Market expansion is sufficient.
Trend flips are allowed.
Gate closed
Market is compressed.
Conditions are likely choppy.
Trend reversals are suppressed.
This effectively turns the indicator into a:
Trend-following system during expansion,
Trend-holding system during compression.
Why ATR ratio works well
ATR ratio is a powerful regime detector because it measures:
Current volatility relative to normal volatility.
Not just:
“Is volatility high?”
But:
“Is volatility high relative to its recent baseline?”
This adaptive behavior allows the gate to work across:
Different assets,
Different timeframes,
Different volatility environments.
Input guide
ATR Multiplier
Controls band width:
Higher = wider bands, fewer flips
Lower = tighter bands, more sensitivity
ATR Length
Controls volatility calculation for the Supertrend itself.
Fast ATR
Short-term volatility measure.
Slow ATR
Long-term baseline volatility measure.
Gate Threshold
Controls how strict the gate is:
Lower threshold = more permissive
Higher threshold = more restrictive
Example:
0.6 → allows more flips
1.0 → requires current volatility to match baseline
1.2 → requires expansion regime
Strengths
Reduces Supertrend whipsaws in chop.
Adds regime awareness.
Uses adaptive volatility filtering.
Clean trend visualization.
Blocked-signal logic provides extra context.
Limitations
Can delay reversals during early expansion.
Very high thresholds may suppress legitimate transitions.
Still fundamentally a trend-following system.
Not designed for low-volatility mean reversion trading.
Best use case
Volatility Gated Supertrend works best as:
A directional regime filter,
A swing trend overlay,
A volatility-aware trend confirmation tool,
A way to suppress noise during consolidations.
It is particularly useful for traders who:
Like Supertrend logic,
But dislike how often it flips in sideways markets.
Summary
Volatility Gated Supertrend extends the classic Supertrend framework by introducing a volatility-aware gating engine that blocks trend reversals during compressed market conditions. By comparing fast ATR against slow ATR, the script determines whether enough volatility expansion exists to justify a directional transition. The result is a cleaner, more stable trend system that retains the strengths of Supertrend logic while dramatically reducing whipsaws during low-energy market regimes. Indicator
Donchian Retest Readiness [AGPro Series]# Donchian Retest Readiness
🧠 Core Idea
After price breaks a Donchian Channel boundary, is the broken edge ready to act as a clean retest and continuation reference?
📌 Overview / What it does
Donchian Retest Readiness is a breakout-boundary decision-support script built around Donchian Channels.
The script maps the rolling Donchian high, low, and midpoint, detects channel breaks, builds a retest pocket around the broken edge, scores retest quality from 0 to 100, and projects continuation lanes with target rails.
It does not predict price direction, automate trades, or provide guaranteed signals. It organizes Donchian break context, retest quality, channel edge, risk, and action state into a clean visual workflow.
🎯 Purpose & Design Philosophy
Many breakout tools mark the moment price leaves a range, but the difficult part often comes after the break: deciding whether the broken edge is being respected.
This script was built for traders who want to evaluate Donchian breakout retests without treating every new high or new low as a complete trading idea.
The design supports structured observation: break first, retest pocket second, hold quality third.
⚡ Why This Script Is Different
Most Donchian tools focus on channel highs and lows.
This script does NOT stop at drawing the Donchian Channel.
Instead, it converts the broken channel edge into a decision zone, evaluates whether price returns to that area, measures hold quality, and summarizes readiness with a clear 0-100 score.
⚙️ Methodology
1. Donchian Channel Mapping
2. Breakout Boundary Detection
3. Retest Pocket Construction
4. Hold / Failure Evaluation
5. 0-100 Retest Readiness Score
6. Panel And Alert Output
🗺️ How to Read the Chart
The Donchian Channel shows the rolling high, low, and midpoint.
The retest pocket appears around the broken channel edge after a breakout.
READY RETEST labels appear when price interacts with the broken edge and holds with enough quality.
Continuation lanes and target rails show the projected area beyond the accepted retest context.
The panel summarizes Break State, Retest Score, Channel Edge, Risk, and Action.
🚦 Signals & States
• READY → A qualified Donchian retest has formed.
• MONITOR → A Donchian break is active and retest behavior is being evaluated.
• WAIT → The channel is valid, but no active break / retest context is present.
• INVALIDATED → Price failed back through the broken channel edge.
• BLOCKED → The Donchian channel is not suitable for evaluation under current settings.
🔔 Alerts Logic
Bullish Donchian Retest Ready triggers when price breaks above the Donchian high, returns to the broken edge, and holds with enough score quality.
Bearish Donchian Retest Ready triggers when price breaks below the Donchian low, returns to the broken edge, and holds with enough score quality.
Donchian Break Watch alerts mark the first boundary break when enabled.
Donchian Retest Invalidated triggers when price fails back through the broken edge.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The retest score combines wick response, close pressure beyond the broken edge, proximity to the retest pocket, breakout impulse, relative volume, and channel width quality.
When several of these conditions align, the retest context becomes stronger.
📊 When to Use
• Breakout markets
• Trend continuation setups
• Pullbacks after new highs or new lows
• Donchian Channel structure analysis
• Intraday or swing contexts where retest behavior matters
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy chop
• Abnormal spread conditions
• News spikes where retest behavior is unstable
• Markets where every boundary break immediately reverses
🎛️ Key Inputs
• Donchian Length → controls the rolling channel high and low.
• ATR Length → controls retest pocket depth, buffers, targets, and label spacing.
• Minimum Channel Width → blocks weak channels that are too narrow.
• Retest Pocket ATR → controls how wide the broken-edge retest pocket is.
• Minimum Ready Score → controls how selective READY states are.
• Projection Bars → controls how far pockets and targets extend.
• Visual settings → control channel, fill, pocket, lane, labels, tags, and panel.
🖥️ Interface & Visual Design
The script uses a clean AG Pro panel to summarize the current Donchian context.
The visual hierarchy is designed to keep the channel visible while making the active retest pocket and READY label easy to see.
Default settings keep failed and early watch labels off so publication screenshots remain clean.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check the Donchian channel boundary.
3. Wait for a break and retest pocket.
4. Evaluate whether price holds the broken edge.
5. Review target rails and failure risk.
🔍 Interpretation Guidelines
A READY retest means the broken Donchian edge is being respected according to the script rules.
It does not mean price must continue.
An invalidated retest means price failed back through the broken edge and the breakout context lost quality.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a buy or sell signal generator.
It is not an automated trading system.
It does not guarantee breakouts, continuation, or reversals.
⚠️ Limitations & Transparency
Donchian behavior can vary by symbol, timeframe, volatility, and liquidity.
Shorter timeframes may produce more noise.
Longer Donchian lengths may react more slowly.
The script should be interpreted within broader structure, market regime, and risk context.
🧠 Market Context Notes
Donchian edges often become meaningful when market participants react to new highs, new lows, and breakout continuation attempts.
The strongest contexts usually combine a clean boundary break, controlled retest, and enough continuation room.
🧾 Use Case Examples
When price breaks above the Donchian high and later retests the broken edge without closing back through it, the script may mark a bullish READY RETEST.
When price breaks below the Donchian low and retests the edge from below with enough quality, the script may mark a bearish READY RETEST.
When price breaks out and then closes back through the broken edge, the retest can become invalidated.
🧱 System Philosophy
This script follows the AGPro Series approach: structured context, practical scoring, clean visuals, and decision-support states instead of noisy prediction claims.
🔐 Non-Promise Statement
No script can provide certainty.
No output should be treated as guaranteed.
All states are rule-based analytical markers.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and position sizing.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The purpose of this script is to help users study Donchian Channel breakout and retest behavior through a structured visual framework.
Indicator
Keltner Squeeze Release Planner [AGPro Series]# Keltner Squeeze Release Planner
🧠 Core Idea
Is volatility compression turning into a clean Keltner Channel release, or is price still trapped inside the squeeze?
📌 Overview / What it does
Keltner Squeeze Release Planner is a volatility compression and expansion decision-support script built around Keltner Channels.
The script detects compressed Keltner width, evaluates whether price releases beyond the channel with enough expansion quality, scores the release from 0 to 100, and maps an expansion corridor with target rails and failure context.
It does not predict price direction, automate trading, or provide guaranteed signals. It organizes squeeze, release quality, volatility rank, direction bias, and action state into a cleaner workflow.
🎯 Purpose & Design Philosophy
Many traders can see a breakout after it happens, but the difficult part is separating real volatility expansion from a weak push outside the channel.
This script was built for traders who want a structured way to read Keltner squeeze behavior, release strength, and early failure risk.
The design supports patience during compression and cleaner observation when price finally leaves the channel.
⚡ Why This Script Is Different
Most Keltner tools draw the channel and leave interpretation to the user.
This script does NOT treat every channel break as meaningful.
Instead, it evaluates compression depth, expansion ratio, close pressure, candle body quality, relative volume, and basis slope before marking a release as READY.
⚙️ Methodology
1. Keltner Channel Mapping
2. Compression Detection
3. Release Edge Evaluation
4. Expansion Quality Scoring
5. Corridor And Failure Mapping
6. Panel And Alert Output
🗺️ How to Read the Chart
The Keltner Channel shows the active volatility envelope around price.
Compression shading marks periods where channel width is low relative to recent history.
BULL RELEASE and BEAR RELEASE labels appear when price leaves the channel with enough release quality.
The release corridor projects possible expansion space after a qualified release.
The panel summarizes Squeeze, Release Score, Volatility, Direction Bias, and Action.
🚦 Signals & States
• READY → A qualified Keltner squeeze release has formed.
• MONITOR → A release context is active and should be observed.
• WAIT → Compression may exist, but release quality is not confirmed.
• INVALIDATED → A release failed back into the channel context.
• BLOCKED → The script cannot define a valid Keltner context.
🔔 Alerts Logic
Bullish Keltner Squeeze Release Ready triggers when price releases above the upper Keltner Channel after compression with enough score quality.
Bearish Keltner Squeeze Release Ready triggers when price releases below the lower Keltner Channel after compression with enough score quality.
Keltner Compression Active triggers when channel width is low enough to qualify as squeeze context.
Keltner Squeeze Release Failed triggers when an active release loses quality and moves back into the failure area.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The release score combines compression depth, expansion ratio, close pressure beyond the channel, candle body quality, relative volume, and basis slope.
When these conditions align, the release context becomes stronger.
📊 When to Use
• Markets moving from low volatility to expansion
• Breakout environments
• Consolidation-to-trend transitions
• Intraday or swing contexts where volatility contraction matters
⚠️ When NOT to Use
• Extremely illiquid symbols
• Random high-noise chop
• News spikes with unstable spreads
• Symbols where Keltner width is distorted by abnormal candles
🎛️ Key Inputs
• Keltner Basis Length → controls the EMA basis of the channel.
• ATR Length → controls channel width and volatility normalization.
• Keltner ATR Multiplier → adjusts how wide the channel is.
• Squeeze Threshold → defines how deep compression must be.
• Minimum Ready Score → controls how selective READY releases are.
• Projection Bars → controls how far the corridor extends.
• Visual settings → control labels, channels, zones, panel, and chart density.
🖥️ Interface & Visual Design
The script uses a compact AG Pro panel to make the current state readable at a glance.
The visual hierarchy is designed to keep the chart clean: channel context first, release label second, corridor and targets third.
Default settings are tuned for readable publication screenshots without hiding the core volatility story.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether compression is active.
3. Wait for a qualified release label.
4. Review the corridor and target rails.
5. Watch whether price holds or fails back into the channel.
🔍 Interpretation Guidelines
A READY release means volatility expansion conditions aligned according to the script rules.
It does not mean price must continue.
A weak or failed release means the channel break lost quality and should be interpreted within broader market context.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a buy or sell signal generator.
It is not an automated trading system.
It does not guarantee breakouts, continuation, or reversals.
⚠️ Limitations & Transparency
Keltner behavior can change across symbols, sessions, and timeframes.
Compression may last longer than expected.
Strong news events can create release signals that behave differently from normal volatility expansion.
The script should be used with broader structure, liquidity, and risk context.
🧠 Market Context Notes
Keltner squeeze behavior is most useful when volatility has contracted enough to create a visible transition point.
The best contexts often combine compression, clean channel release, participation, and enough room for expansion.
🧾 Use Case Examples
When price compresses inside the Keltner Channel and then closes beyond the upper band with strong expansion, the script may mark a bullish release.
When price breaks below the lower band after compression and the release score is strong enough, the script may mark a bearish release.
When price breaks out but quickly moves back into the channel, the release can lose quality.
🧱 System Philosophy
This script is part of the AGPro Series approach: clean visual context, practical scoring, and decision-support states instead of noisy prediction labels.
🔐 Non-Promise Statement
No script can provide certainty.
No signal should be treated as guaranteed.
All outputs are rule-based analytical markers.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and position sizing.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The purpose of this script is to help users study volatility compression and release behavior through a structured Keltner Channel framework.
Indicator
Strategy
Auction Structure Ledger [JOAT]Auction Structure Ledger
Introduction
Auction Structure Ledger is an open-source Pine Script v6 indicator that transforms confirmed pivot behavior into structured auction zones. Instead of treating every swing high and swing low as equally important, the script looks for clustered defended pivots, measures how much volume-confluence exists at those prices, and converts the result into support and resistance shelves that persist, update, and eventually retire as price accepts or fails them.
The problem this indicator solves is structural ambiguity. Many charts contain repeated pivot noise that does not deserve equal visual weight. A single swing high does not automatically represent meaningful supply, and a single swing low does not automatically represent meaningful demand. Auction Structure Ledger filters pivot activity through clustering logic and local volume-confluence so the chart emphasizes defended areas where auction acceptance and rejection are more likely to matter.
The script is useful for traders who think in terms of accumulation, distribution, acceptance, and failure. It does not attempt to forecast the future from one oscillator reading. It organizes the chart around defended reference zones, tracks how price behaves around them, and summarizes the current auction state in a way that can support discretionary analysis or other rule-based systems.
Because it combines pivot clustering with a volume-confluence layer, the indicator is not simply painting boxes around old highs and lows. It is trying to identify where the market repeatedly acknowledged a price region and whether that region still behaves as support or resistance.
Core Concepts
1. Pivot Confirmation And Structural Timing
The script uses `ta.pivothigh()` and `ta.pivotlow()` to confirm swing highs and lows with a symmetric lookback. This means zones are only created after the pivot is actually confirmed, which avoids the false certainty that comes from drawing structure before the right-side bars exist.
float pivotHigh = ta.pivothigh(high, pivotLength, pivotLength)
float pivotLow = ta.pivotlow(low, pivotLength, pivotLength)
This is deliberate non-repainting behavior. The structure appears later than the original pivot candle, but it appears only after the market has confirmed the swing.
2. Clustered Defense Rather Than Single-Pivot Noise
Once a pivot appears, the script scans a configurable cluster window to count how many nearby pivots formed within an ATR-based tolerance. That cluster count becomes part of the zone’s strength score.
This is what gives the ledger its auction logic. A zone becomes more meaningful when the market keeps defending the same approximate level rather than printing a one-off pivot and moving on.
3. Volume-Confluence Layer
The script builds a rolling volume distribution across the current price window and checks how much of that distribution sits at the pivot price. That reading is normalized into a confluence percentage.
In practice, this means a clustered pivot with low local volume-confluence is treated differently from a clustered pivot that sits in a high-activity price region. The first may represent weak structure. The second may represent a more meaningful auction shelf.
4. Support And Resistance Shelf Construction
When a pivot passes the cluster criteria, the script creates a zone with ATR-based width. Resistance shelves are built above price with an offered profile. Support shelves are built below price with a bid profile. Each shelf contains a body, a spine line through the midpoint, and an information label summarizing the zone.
The shelf width is not arbitrary. It scales with ATR so zones remain proportionate across different volatility conditions and instruments.
5. Acceptance And Failure Tracking
After a zone is created, the script continues monitoring it. If price trades within the zone and remains inside it, the shelf is counted as accepted. If price closes through the invalidation side of the shelf, it is counted as failed and eventually removed after a short lifecycle buffer.
That behavior matters because the market is not static. A valid shelf today can become irrelevant after repeated acceptance or a decisive failure.
Features
Cluster-confirmed auction shelves: Builds zones only when pivots cluster within an ATR-based tolerance
Support and resistance separation: Maintains bid-side and offered-side structure independently
Volume-confluence scoring: Measures how much rolling price-volume concentration supports each shelf
ATR-scaled zone width: Keeps shelf geometry adaptive to volatility instead of fixed-width boxes
Acceptance and failure tracking: Continues scoring shelves after creation as price interacts with them
Confluence ribbon: Displays whether current price is trading in a high-confluence region of the rolling ledger
Nearest distance metrics: Shows the ATR distance to the closest active support and resistance shelves
Institutional dashboard: Summarizes support count, resistance count, acceptance rate, failure rate, bias, and strongest zone
Confirmed-bar alert set: Includes bullish ledger, bearish ledger, fresh support, and fresh resistance alerts
Data-window outputs: Exposes structure counts and confluence values for additional interpretation
Visual Elements
Auction shelves: Each zone is rendered as a structured body rather than a simple line so the user can read width and tolerance clearly
Shelf spine: A dotted midpoint line marks the internal balance area of each shelf
Confluence ribbon: The ribbon around price shows whether the current location overlaps with strong rolling confluence
Responsive color logic: Support, resistance, touched, and failed states each alter the way the shelf is displayed
Compact info labels: Each zone carries its own context label so the chart remains interpretable without opening settings
Best Practices
Give more weight to shelves that combine both repeated pivot defense and strong volume-confluence
Watch how price behaves on the first return to a new shelf before assuming the level is strong
Treat accepted zones and failed zones differently because they tell very different auction stories
Use nearest support and resistance ATR distances to understand whether price is extended or structurally balanced
Combine the ledger with your own trigger logic rather than assuming shelf presence alone is a complete trade plan
Input Parameters
Structure Engine:
Pivot Length: Sets how many bars are required on each side of a pivot to confirm it
ATR Length: Controls the volatility measure used for zone sizing and tolerance logic
Shelf ATR Width: Sets the width of each auction shelf relative to ATR
Cluster Window: Defines how far back the script scans for repeated nearby pivots
Cluster ATR Tolerance: Determines how close pivots must be to count as the same structural cluster
Volume Confluence:
Volume Window: Sets the rolling price-volume study range
Volume Bins: Controls the granularity of the confluence distribution
Confluence Strength Threshold: Defines when the ribbon should represent strong price-volume overlap
Show Confluence Ribbon: Toggles the contextual ribbon around price
Display:
Show Dashboard: Enables the top-right structural summary
Color inputs: Allow independent styling for support, resistance, neutral, and panel colors
How to Use This Indicator
Step 1: Start With The Bias Row
The dashboard summarizes whether active support shelves outnumber resistance shelves, whether the market is balanced, and how strong the current ledger looks. This gives immediate context before focusing on individual zones.
Step 2: Identify The Strongest Active Shelf
Check the strongest zone reading and visually locate the shelf with the most emphasis. This is often the most useful structural reference when price approaches an auction boundary.
Step 3: Watch Acceptance Versus Failure
Acceptance means price is interacting with the zone without invalidating it. Failure means price has moved through the wrong side of the shelf. A high failure rate weakens the reliability of the current ledger.
Step 4: Use The Nearest ATR Distances
The dashboard shows the ATR distance to the nearest support and resistance shelves. That helps frame whether price is sitting directly on a structure reference or is trading between meaningful levels.
Step 5: Combine With Your Own Execution Model
Auction Structure Ledger is most useful as a context layer. It defines where defended structure exists. It does not decide entries or exits for you. Use the zones to frame reactions, continuation decisions, or risk placement inside your own process.
Indicator Limitations
Pivot-based structure is inherently delayed because the script waits for right-side confirmation before creating a shelf
A clustered pivot region can still fail immediately if broader market flow overwhelms the local auction structure
Rolling volume-confluence is context-dependent and can shift as the lookback window evolves
Zones are analytical references, not guarantees that support or resistance will hold on the next test
Originality Statement
Auction Structure Ledger is original in the way it turns clustered pivot defense and rolling volume-confluence into a persistent auction map. This is more than a standard support and resistance overlay:
It requires repeated pivot behavior before treating a level as meaningful structure
It combines cluster count and volume-confluence into a unified strength score for each shelf
It tracks acceptance and failure after creation so zones remain part of a living ledger rather than a static drawing layer
It presents the structure through a bias dashboard and confluence ribbon that helps translate zone behavior into usable chart context
Disclaimer
This indicator is provided for educational and informational purposes only. It is not financial advice or a recommendation to buy or sell any financial instrument. Support and resistance shelves represent historical auction behavior, not guaranteed future turning points. Markets can accept, reject, or ignore any level without warning. Always use independent judgment and appropriate risk management.
-Made with passion by jackofalltrades
Indicator
Liquidity Pool Detector [EXCAVO]Equal High/Low Cluster Detection with Sweep Identification and Period Reference Levels
The Liquidity Pool Detector identifies where resting orders accumulate near swing
levels by detecting equal highs and equal lows using swing pivot analysis with ATR-based
tolerance. When price wicks through a cluster level and closes back inside, the indicator
marks a sweep - the moment orders at that level were filled and price reversed direction.
This is not a basic pivot-high/low indicator. The cluster-merging logic groups nearby
pivots into unified levels with touch counts, and the sweep filter distinguishes between
a genuine zone test and a breakout continuation.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ HOW TO USE
Step 1 → Add the indicator to the price chart. Red solid lines appear above
price (equal highs clusters) and blue solid lines appear below price
(equal lows clusters). Previous day and week H/L reference levels
appear as slightly thicker dotted lines.
Step 2 → Watch for sweep markers. "Highs Swept" appears on a bar where price
wicked above an equal-highs cluster and closed back below it. "Lows
Swept" appears below a bar where price wicked below equal lows and
closed above. These bars indicate price tested and reversed from a cluster level.
Step 3 → Read the touch count on each cluster label. "Highs ×3" means three
swing highs formed at approximately the same level - a stronger cluster
with a stronger level formed by more historical touches.
Step 4 → Check the dashboard. Dist to High and Dist to Low show how many ATR
units separate current price from the nearest cluster above and below.
Values below 1.0 ATR highlight in orange - price is close to a level.
Nearest High and Nearest Low show the exact price of those levels.
Step 5 → Set up sweep alerts to receive notifications on bar close when a
cluster level is tested and rejected. Use JSON Alerts for bot integration.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ HOW IT CALCULATES
◆ Swing Pivot Detection
The indicator uses ta.pivothigh() and ta.pivotlow() with a configurable Swing Length
(default 3). A pivot high is confirmed when the bar's high is the highest point among
the surrounding N bars on each side - requiring N bars to the left and N bars to the
right, so detection occurs N bars after the actual pivot forms. This lag ensures the
pivot is fully confirmed and the value never changes after the bar closes. Lower Swing
Length values (2-3) suit intraday timeframes; higher values (5) suit daily charts.
◆ Cluster Merging (ATR Tolerance)
When a new confirmed pivot is detected, the indicator compares it against all existing
clusters of the same type. If the distance between the new pivot and an existing cluster
level is within the Equal Tolerance threshold (default 0.5 x ATR), the pivots are merged:
the cluster level is updated to the weighted average of all touches, and the touch count
increments. If no nearby cluster exists and the cluster limit has not been reached, a new
cluster is created at that price level. This approach prevents visual noise from minor
price variations between otherwise equal levels.
◆ Sweep Detection
On each confirmed bar close, every active cluster is checked against two conditions.
For equal-highs clusters: if the bar's high exceeded the cluster level AND the close is
below the cluster level, a sweep is registered - price moved through the zone of resting
orders and reversed. For equal-lows clusters: if the bar's low was below the cluster level
AND the close is above it, a sweep is registered. A close through the level without
reversal (close >= highs cluster, or close <= lows cluster) is treated as a breakout:
the cluster is invalidated and removed without a sweep marker.
◆ Period Reference Levels
Previous Day High/Low and Previous Week High/Low are fetched using request.security()
with a confirmed-bar offset (high / low with barmerge.lookahead_on). These levels
are included in the Nearest High and Nearest Low dashboard calculations alongside the
detected equal-high/low clusters.
◆ Non-Repainting Design
All cluster additions, sweep detections, and invalidations are gated on
barstate.isconfirmed. No cluster is created and no sweep marker is placed until the bar
closes. Pivot detection uses a right-bar offset that confirms the pivot on a fully closed
bar. No value changes after a bar is confirmed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ WHAT MAKES IT DIFFERENT
◆ ATR-Based Cluster Tolerance
Most equal-high/low detectors use a fixed pip or percentage threshold that fails across
different instruments and timeframes. Using ATR as the tolerance baseline means the same
settings work on BTCUSD hourly (high ATR) and EURUSD daily (low ATR) without manual
recalibration. The tolerance adapts to current market conditions automatically.
◆ Cluster Merging with Touch Count
Instead of drawing a separate line for every swing pivot, nearby pivots are merged into a
single cluster with an incrementing touch count. A cluster labeled "Highs ×3" represents
three independent swing highs at the same level - a significantly stronger zone than a
single untested level. The line and label update in place as new touches are added.
◆ Sweep vs Breakout Distinction
The indicator explicitly separates sweep bars (wick through, close back inside) from
breakout bars (close through the level). A sweep generates a "Highs Swept" or "Lows
Swept" marker and an alert. A breakout silently removes the cluster. This distinction
matters: sweeps are potential reversal setups; breakouts confirm continuation.
◆ Period Levels as Part of the Analysis
Previous Day and Week H/L are integrated into the same framework as the equal-high/low
clusters. They appear in the Nearest High/Low dashboard calculation and use the same color
scheme as cluster lines, making them immediately readable alongside the dynamically
detected clusters.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ DASHBOARD
Compact panel showing current conditions:
Dist to High - distance from current price to nearest cluster above, in ATR units; turns orange below 1.0 ATR
Dist to Low - distance from current price to nearest cluster below, in ATR units; turns orange below 1.0 ATR
Nearest High - exact price of the closest active cluster or period level above
Nearest Low - exact price of the closest active cluster or period level below
Last Sweep - most recent sweep type: Highs Swept, Lows Swept, or - (none)
Swing - active swing length parameter
Legend table (bottom left) explains cluster lines, period levels, and sweep markers.
Both panels toggle in Dashboard settings.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ SETTINGS
Detection
Swing Length - 3 bars (pivot confirmation window left and right; use 2-3 for intraday, 5 for daily)
Equal Tolerance (x ATR) - 0.5 (cluster merge radius as ATR multiple)
Max Clusters - 10 (maximum active clusters tracked per direction)
Max Display Distance (x ATR) - 5.0 (clusters beyond this ATR distance from price are hidden; detection continues)
Period Levels
Show Prev Day H/L - ON (previous day high and low reference lines)
Show Prev Week H/L - ON (previous week high and low reference lines)
Visualization
Bull Color - default blue (equal-lows clusters and lows-swept markers)
Bear Color - default red (equal-highs clusters and highs-swept markers)
Sweep Color - default orange (sweep marker labels)
Show Sweep Markers - ON (labeled markers on sweep bars)
Background Highlight - OFF (subtle tint when price is within one ATR of nearest cluster)
Alerts
JSON Alerts - OFF (enable for bot integration)
Dashboard
Dashboard Position - Top Right
Show Dashboard - ON
Show Legend - ON
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ ALERTS
Highs Swept - price wicked above equal-highs cluster and closed below on bar close
Lows Swept - price wicked below equal-lows cluster and closed above on bar close
Any Sweep - any cluster level tested and rejected on bar close
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Best regards,
EXCAVO
Disclaimer
Trading involves significant risk. This indicator is a technical analysis tool
and does not constitute financial advice, investment recommendations, or a
guarantee of future results. Past indicator behavior does not guarantee future
performance. Always use proper risk management and your own judgment.
Indicator
Position Sizing CalculatorA simple automated calculator that shows how many shares can be bought or sold if a specific maximum amount is to be risked on the position.
The risk per share is assumed to be the distance to the respective buy or sell line of the Supertrend indicator. This is based on a calculation of the ATR for the last ten days, which is multiplied by a fixed factor and plotted against the highest or lowest candle of the past ten days.
The parameters can be changed manually. By default, a risk of $500 per trade is assumed.
For each of the last bars, the calculator displays the distance to the calculated exit and, through a simple division, calculates the number of shares that could be bought or sold in a potential long or short position to achieve this hypothetical maximum risk.
Of course, there is no guarantee that the respective price will actually be reached, but the calculator can help provide a reference point for sizing the position.
The principle is clearly visible in the screenshots: FRT is a stock that moves slowly and is only a short distance from the stop-loss level. At the current price of $114.47 and a calculated stop at $108.99, 91 shares could be purchased to risk $500. In total, that would be an order of $10,416.77 for a long position.
SOUN, on the other hand, has a very wide margin to the stop-loss; it is a stock with high volatility. Therefore, only 300 shares can be purchased here to achieve the same hypothetical risk. The position would thus be worth only $2,841.
Designed by tuvot_1a, programmed by Claude.
Indicator
Indicator
Indicator
