Price Structure RSIOverview
Price Structure RSI is a market-structure oscillator that converts confirmed structural breaks into a cumulative directional series and then applies the Relative Strength Index calculation to that series.
Unlike a traditional RSI, which is calculated directly from price changes, this indicator measures how previously identified pivot highs and pivot lows are being broken.
The oscillator includes:
- market-structure-based RSI
- configurable RSI length
- configurable overbought and oversold levels
- Close or High/Low structure-break confirmation
- optional EMA, SMA, or WMA smoothing
- confirmed bullish and bearish signals
- dark and light colour presets
- gradient oscillator visualization
- simplified bullish and bearish historical W/L panels
- configurable target and stop distances
- configurable panel positions
- bullish and bearish alerts
The indicator is intended to help users examine whether recent market-structure breaks are producing stronger bullish or bearish pressure.
It does not predict future price movement and does not provide automatic instructions to enter or exit a trade.
Open-source reuse and credits
Price Structure RSI is a modified and expanded derivative of the open-source indicator "Market Structure RSI" by ClayeWeight.
The original pivot detection, stored structure levels, broken-structure accumulation, cumulative structure total, RSI transformation, moving-average selection, threshold-crossing signals, and alert framework were adapted from ClayeWeight's work.
This version adds:
- Pine Script v6 compatibility
- dark and light colour presets
- revised oscillator colours and gradient fills
- confirmed-bar signal processing
- configurable historical target and stop measurements
- next-bar outcome evaluation
- conservative same-bar target and stop handling
- separate bullish and bearish W/L panels
- configurable panel positioning and offsets
- additional input validation
- revised alert messages
The original source was published under the Mozilla Public License 2.0.
This modified version is also published open-source under the Mozilla Public License 2.0.
Core methodology
The indicator first identifies simple confirmed pivot highs and pivot lows.
A pivot high is identified when:
- the centre candle has a higher high than the candle before it
- the centre candle has a higher high than the candle after it
A pivot low is identified when:
- the centre candle has a lower low than the candle before it
- the centre candle has a lower low than the candle after it
Because the script evaluates historical candles, the pivot is recognized only after the necessary later candle has closed.
Confirmed pivot-high prices are stored in an array.
Confirmed pivot-low prices are stored in a separate array.
Structure breaks
The indicator checks whether stored pivot levels have been broken.
Users can select one of two Structure Break Type settings:
- Close
- High/Low
When Close is selected:
- a stored pivot high is considered broken when the previous candle closes above it
- a stored pivot low is considered broken when the previous candle closes below it
When High/Low is selected:
- a stored pivot high is considered broken when the previous candle high moves above it
- a stored pivot low is considered broken when the previous candle low moves below it
When one or more stored pivot highs are broken, positive values are added to the cumulative structure total.
When one or more stored pivot lows are broken, negative values are added to the cumulative structure total.
Broken levels are removed from their respective arrays so that the same structure level is not counted repeatedly.
Cumulative structure total
Each broken pivot high contributes:
- +1
Each broken pivot low contributes:
- -1
If several stored structure levels are broken together, several values can be added during the same calculation.
The script then calculates the cumulative sum of these positive and negative structure changes.
A rising structure total indicates that more stored pivot highs are being broken.
A falling structure total indicates that more stored pivot lows are being broken.
Structure RSI
The Relative Strength Index calculation is applied to the cumulative structure total rather than directly to price.
The default RSI Length is:
- 20
The resulting oscillator is called the Structure RSI.
Higher Structure RSI values indicate that bullish structure breaks have recently had greater influence on the cumulative series.
Lower Structure RSI values indicate that bearish structure breaks have recently had greater influence.
The Structure RSI should not be interpreted as a standard price RSI because its input is the cumulative structure-break series rather than normal closing-price changes.
Overbought and oversold levels
The default levels are:
- Overbought Level: 80
- Oversold Level: 20
The Oversold Level must remain below the Overbought Level.
The script displays an error when the oversold setting is equal to or above the overbought setting.
The levels are configurable and should be treated as analytical thresholds rather than universally optimal settings.
Bullish signal
A bullish signal occurs when the Structure RSI crosses upward through the selected Oversold Level.
The signal is confirmed only after the chart candle closes.
The bullish marker appears at the bottom of the oscillator pane.
A bullish signal indicates that the structure-based oscillator has recovered above its lower threshold.
It does not guarantee that price will continue higher.
Bearish signal
A bearish signal occurs when the Structure RSI crosses downward through the selected Overbought Level.
The signal is confirmed only after the chart candle closes.
The bearish marker appears at the top of the oscillator pane.
A bearish signal indicates that the structure-based oscillator has moved back below its upper threshold.
It does not guarantee that price will continue lower.
Moving average
An optional moving average can be applied to the Structure RSI.
Available moving-average types are:
- EMA
- SMA
- WMA
The default settings are:
- Moving Average Type: EMA
- Moving Average Length: 8
The moving average can be used to observe the smoother direction of the Structure RSI.
The moving average does not directly create the bullish or bearish threshold signals.
Hiding the moving average does not change the Structure RSI calculation.
Oscillator colours
The Structure RSI line changes colour according to its current position.
- Above the Overbought Level: bearish colour
- Below the Oversold Level: bullish colour
- Between the two levels: neutral grey
The oscillator also includes:
- a dashed overbought line
- a dashed oversold line
- a dotted 50 midline
- a neutral background fill between the main levels
- bullish and bearish gradient fills
- optional dark and light colour presets
The colour settings change presentation only.
They do not alter the structure calculation or signal logic.
Confirmed signals
Bullish and bearish signals are accepted only on confirmed chart bars.
The script does not finalize a signal solely because the Structure RSI temporarily crosses a threshold while the active candle is still open.
Values may still move while the current chart candle develops.
The final marker and alert are generated only after the candle closes with the crossing condition confirmed.
Historical W/L measurements
The indicator includes simplified historical bullish and bearish outcome measurements.
These measurements are not a complete PulseWire strategy backtest.
When no measurement is currently active, a confirmed signal can begin a new historical measurement.
For a bullish signal:
- the signal candle close becomes the recorded entry price
- the target is placed above the recorded entry
- the stop is placed below the recorded entry
For a bearish signal:
- the signal candle close becomes the recorded entry price
- the target is placed below the recorded entry
- the stop is placed above the recorded entry
Only one unresolved historical measurement is tracked at a time.
Target distance
Target Distance (%) controls the percentage distance between the recorded signal close and the historical target.
The default value is:
- 1.0%
For a bullish measurement:
- Target = Entry Price × (1 + Target Percentage)
For a bearish measurement:
- Target = Entry Price × (1 - Target Percentage)
The minimum allowed target distance is 0.1%.
Stop distance
Stop Distance (%) controls the percentage distance between the recorded signal close and the historical stop.
The default value is:
- 1.0%
For a bullish measurement:
- Stop = Entry Price × (1 - Stop Percentage)
For a bearish measurement:
- Stop = Entry Price × (1 + Stop Percentage)
The minimum allowed stop distance is 0.1%.
Next-bar evaluation
Target and stop evaluation begins on the bar after the signal.
The signal candle itself is not used to determine the result.
This prevents price movement that occurred earlier during the signal candle from being counted after the entry has been recorded at that candle's close.
Wins and losses
The tables use the following labels:
- W = Win
- L = Loss
A win means that the configured target was reached before the configured stop.
A loss means that the configured stop was reached before the configured target.
The displayed percentage is:
- Wins divided by completed Wins and Losses
Bullish and bearish measurements are counted separately.
Same-bar target and stop handling
A chart candle can sometimes touch both the target and stop.
Standard OHLC chart data does not reveal which level was reached first inside that candle.
When both levels are touched during the same bar, the script records a loss.
This conservative rule avoids automatically assuming the more favourable outcome.
The script does not reconstruct lower-timeframe intrabar movement.
One active measurement at a time
Only one unresolved historical measurement can be active.
When a measurement is already active:
- later bullish or bearish signals can still appear
- later signals can still trigger alerts
- later signals do not start another W/L measurement
- the active measurement remains open until its target or stop is reached
An opposite signal does not automatically close the existing measurement.
This means that not every displayed signal is included in the W/L panels.
Bull panel
The Bull panel displays results from completed bullish measurements.
The panel contains:
- Bull
- W: number of bullish targets reached first
- L: number of bullish stops reached first
- percentage of completed bullish measurements recorded as wins
The Bull panel position can be selected from the available chart locations.
Bear panel
The Bear panel displays results from completed bearish measurements.
The panel contains:
- Bear
- W: number of bearish targets reached first
- L: number of bearish stops reached first
- percentage of completed bearish measurements recorded as wins
The Bear panel position can be selected independently from the Bull panel.
Panel positions and offsets
The Bull and Bear panels can be placed at:
- top left
- top centre
- top right
- middle left
- middle centre
- middle right
- bottom left
- bottom centre
- bottom right
Row and column offsets can be used to move each panel within the available position grid.
Negative row values move the selected panel upward.
Positive row values move it downward.
Negative column values move it to the left.
Positive column values move it to the right.
The final position is restricted to the available PulseWire table locations.
The panels can overlap when both are assigned to the same effective position.
Meaning of the displayed percentage
The percentage represents the share of completed measurements where the configured target was reached before the configured stop.
It is not:
- a guaranteed win rate
- proof of future profitability
- a complete strategy result
- a recommendation to enter a trade
- a forecast of future performance
The historical measurement does not include:
- commissions
- spread
- slippage
- liquidity
- order execution
- position sizing
- account equity
- partial exits
- trailing stops
- market gaps
- order rejection
- overlapping positions
- complete intrabar sequencing
Historical results do not guarantee future results.
Alerts
The indicator includes two alert conditions:
- Bullish Signal
- Bearish Signal
The Bullish Signal alert is triggered when the Structure RSI crosses upward through the Oversold Level on a confirmed chart bar.
The Bearish Signal alert is triggered when the Structure RSI crosses downward through the Overbought Level on a confirmed chart bar.
When creating PulseWire alerts, use:
- Once Per Bar Close
This matches the confirmed signal logic.
How to Use
1. Apply the indicator
Add Price Structure RSI to a standard PulseWire chart.
The oscillator appears in a separate pane below the main price chart.
2. Begin with the default settings
The default configuration is:
- RSI Length: 20
- Overbought Level: 80
- Oversold Level: 20
- Structure Break Type: High/Low
- Moving Average Type: EMA
- Moving Average Length: 8
- Target Distance: 1.0%
- Stop Distance: 1.0%
Review the indicator with its default configuration before changing several settings simultaneously.
3. Select the structure-break type
Choose High/Low when a stored structure level should be considered broken as soon as the previous candle's high or low passes it.
Choose Close when the previous candle must close beyond the stored structure level.
High/Low is generally more responsive.
Close is generally more restrictive.
Neither setting is automatically more accurate.
4. Read the Structure RSI
Use the oscillator to observe the balance of recent broken pivot highs and pivot lows.
A rising oscillator indicates that bullish structure breaks are having greater recent influence.
A falling oscillator indicates that bearish structure breaks are having greater recent influence.
The oscillator can remain elevated or depressed during extended directional conditions.
5. Read the overbought area
When the Structure RSI moves above the Overbought Level, bullish structure-break pressure has pushed the oscillator into its upper region.
The bearish signal does not occur merely because the oscillator is above the level.
The bearish signal occurs only when the oscillator later crosses downward through the Overbought Level on a confirmed bar.
6. Read the oversold area
When the Structure RSI moves below the Oversold Level, bearish structure-break pressure has pushed the oscillator into its lower region.
The bullish signal does not occur merely because the oscillator is below the level.
The bullish signal occurs only when the oscillator later crosses upward through the Oversold Level on a confirmed bar.
7. Wait for the candle to close
Signals are confirmed at bar close.
Do not treat a temporary intrabar threshold crossing as a finalized signal.
Wait for the marker to remain after the chart candle closes.
8. Use the moving average
Enable the moving average to observe a smoother version of the Structure RSI.
Available types are:
- EMA
- SMA
- WMA
A shorter moving-average length reacts more quickly.
A longer moving-average length responds more slowly.
The moving average can provide visual context, but it is not part of the threshold-crossing signal condition.
9. Configure the target and stop distances
Set Target Distance (%) and Stop Distance (%) according to the historical measurement you want to study.
For example:
- Target: 1.0%
- Stop: 1.0%
This creates an equal-distance historical measurement.
Another example:
- Target: 2.0%
- Stop: 1.0%
This creates a larger target than stop.
These settings are research parameters and are not recommended trading settings.
10. Read the Bull panel
The Bull panel measures completed bullish signals.
- W means the bullish target was reached first
- L means the bullish stop was reached first
- the percentage shows bullish wins divided by completed bullish outcomes
Only signals that begin while no other measurement is active are included.
11. Read the Bear panel
The Bear panel measures completed bearish signals.
- W means the bearish target was reached first
- L means the bearish stop was reached first
- the percentage shows bearish wins divided by completed bearish outcomes
Only signals that begin while no other measurement is active are included.
12. Understand same-bar outcomes
When both the target and stop are touched during the same candle, the result is counted as a loss.
This is a conservative assumption because the chart's OHLC data cannot show which level was reached first.
13. Understand skipped measurements
A signal can appear while another historical measurement is still unresolved.
That signal can still:
- display a marker
- trigger an alert
However, it does not begin another historical measurement.
This is why the total W/L count may be lower than the total number of visible signals.
14. Position the panels
Choose separate positions for the Bull and Bear panels.
The default positions are:
- Bull panel: top left
- Bear panel: top right
Use the row and column offsets when small position adjustments are needed.
Avoid assigning both panels to the same final position unless overlapping panels are intended.
15. Select the colour preset
Use Dark Background on dark chart themes.
Use Light Background on light chart themes.
The preset changes moving-average and panel text colours.
It does not change the indicator calculations.
16. Create alerts
Create separate PulseWire alerts for:
- Bullish Signal
- Bearish Signal
Use Once Per Bar Close.
Test alerts on the intended symbol and timeframe before using them operationally.
17. Review broader market context
Use Price Structure RSI together with additional analysis such as:
- trend direction
- price structure
- support and resistance
- volume
- volatility
- liquidity
- market sessions
- recent swing highs and lows
- scheduled economic or company events
- risk management
A threshold crossing alone does not guarantee a reversal or continuation.
Suggested starting process
- Apply the indicator to a standard candlestick chart
- Keep RSI Length at 20
- Keep the levels at 80 and 20
- Begin with High/Low structure breaks
- Keep the EMA smoothing line enabled
- Use a target and stop distance of 1.0%
- Wait for confirmed bar-close signals
- Compare the oscillator with visible price structure
- Review the Bull and Bear panels separately
- Remember that only one active measurement is tracked
- Test several symbols and timeframes before drawing conclusions
- Use Once Per Bar Close for alerts
Limitations
- The indicator is derived from the open-source Market Structure RSI by ClayeWeight
- The central structure-break accumulation methodology is adapted from the original work
- Pivot identification is based on a simple three-candle relationship
- Pivots are identified only after the required later candle has closed
- The oscillator measures broken stored structure levels rather than normal price momentum
- The Structure RSI can behave differently from a standard price RSI
- The indicator does not determine whether a structure break is genuine or false
- The indicator does not measure volume, volatility, liquidity, or trend strength
- Signals are confirmed at bar close and may occur later than temporary intrabar conditions
- A bullish signal does not guarantee that price will rise
- A bearish signal does not guarantee that price will fall
- Only one unresolved historical measurement is tracked at a time
- Not every visible signal is represented in the W/L panels
- Opposite signals do not close active measurements
- Target and stop evaluation begins on the bar after the signal
- Same-bar target and stop contact is recorded as a loss
- The W/L panels are simplified historical measurements
- The displayed percentages are not complete backtest results
- Commissions, spread, slippage, liquidity, position sizing, and execution are not included
- Historical outcomes do not imply future results
- The indicator should not be used as the sole basis for a trading decision
Price Structure RSI is an analytical and research tool.
It does not provide financial advice, guaranteed signals, guaranteed win rates, or guaranteed results. Indicator
EGADE Research-Based RSI Threshold ConfigurationEGADE Research-Based RSI Threshold Configuration is an empirical RSI decision-support indicator based on the findings of research by Hatem Mabrouk , Federico Trigos , and Francisco Valderrey , Tecnologico de Monterrey, EGADE Business School, Mexico
The underlying study systematically evaluated nine RSI threshold configurations across nine major cryptocurrencies and the S&P 500 using weekly RSI(14) data. The findings challenge the conventional assumption that the standard 30/70 configuration is universally optimal and identify asset-specific dominant threshold configurations based on win rate, geometric weekly return, and average holding period.
This indicator operationalizes those empirical findings directly within PulseWire. For assets included in the study, it automatically displays the research-based RSI threshold configuration identified by the empirical analysis.
The indicator provides three display modes:
• Research-Based: Displays the empirically identified threshold configuration for the selected asset.
• Conventional 30/70: Displays the traditional RSI 30/70 configuration.
• Compare Both: Displays the research-based and conventional configurations simultaneously for direct comparison.
The indicator uses weekly RSI(14) regardless of the chart timeframe and provides visual entry and exit zones, threshold-entry markers, alerts, and an information dashboard.
Assets currently supported by the empirical research: BTC, ETH, ADA, AVAX, BNB, DOGE, SOL, TRX, XRP, and the S&P 500.
Disclaimer: The findings and information presented through this indicator are intended exclusively for academic, research, educational, and decision-support purposes. Nothing contained in the underlying study or this indicator constitutes financial or investment advice, an investment recommendation, or a solicitation to buy or sell any financial instrument. Historical empirical performance does not guarantee future results. Users should conduct their own analysis and exercise independent judgment when making financial or investment decisions. Indicator
Relative Strength (RS) - Mansfield StyleRelative Strength (RS) measures how a symbol performs against a chosen
benchmark. Instead of plotting the raw price ratio — whose scale differs
from one symbol to another and makes comparison difficult — this script
normalizes the ratio (symbol close / benchmark close) against its own
simple moving average over a configurable lookback "Period". The result
is a zero-centered line that reads the same way on any symbol:
- RS above 0 and rising → the asset is outperforming the benchmark
- RS below 0 and falling → the asset is underperforming
- Zero-line crossings → shifts in relative leadership
Only the direction and the position relative to zero matter, not the
absolute value.
█ HOW IT WORKS
1. The script requests the benchmark's close on the selected timeframe.
2. It computes the raw ratio: symbol close / benchmark close.
3. The ratio is divided by its SMA over the "Period" lookback, minus 1 —
expressing how far the current relative strength stands above or
below its recent average.
4. An optional moving average of RS can be displayed as a signal line.
█ INPUTS
- Comparative Symbol: the benchmark (an index such as SPX, a sector
index, or any peer symbol — e.g. compare gold against silver).
- Period (default 50): normalization lookback. Shorter = more reactive,
longer = smoother and slower.
- Show Moving Average / Moving Average Period: optional smoothing line.
- Timeframe: leave empty to use the chart's timeframe, or select a
higher timeframe for multi-timeframe analysis.
█ HOW TO USE
Apply the indicator to any symbol. When RS holds above zero, the asset
is leading its benchmark — favor it for relative-strength strategies
(buy strength). When RS holds below zero, the asset is lagging — avoid
it or rotate out. Zero-line crossovers flag early changes in relative
leadership, and two built-in alerts fire on these crossings.
RS is a relative tool, not a timing tool: an asset can outperform a
falling benchmark while still declining in absolute terms. Combine it
with your own trend or entry criteria.
█ CREDITS
The normalization method follows the Mansfield Relative Strength
concept popularized by Stan Weinstein in "Secrets for Profiting in
Bull and Bear Markets".
█ NOTE ON HIGHER TIMEFRAMES
When a higher timeframe is selected in the Timeframe input, the value
of the current forming bar updates until that bar closes. Historical
values do not repaint. Indicator
Indicator
DAX Universe Relative Strength & Volume Quality [JS]DAX Universe RS & Volume Quality is a relative strength and pullback quality indicator designed for German stocks from the DAX, MDAX, SDAX and TecDAX universe.
The indicator measures a stock’s weighted relative performance against an equal-weighted German equity benchmark made from DAX, MDAX, SDAX and TecDAX. The relative strength model is inspired by IBD / Minervini-style momentum analysis, giving more weight to recent performance while still considering the medium- and longer-term trend.
Relative Strength Model:
• 40% weight: approx. 3-month performance
• 20% weight: approx. 6-month performance
• 20% weight: approx. 9-month performance
• 20% weight: approx. 12-month performance
The result is displayed as a percentage relative to the German stock universe benchmark:
• RS above 0% = the stock is outperforming the benchmark
• RS below 0% = the stock is underperforming the benchmark
• RS above the user-defined strength threshold = RS STARK / strong relative strength
In addition to relative strength, the indicator includes a High-Volume Down-Day filter. This helps assess whether a pullback is still constructive or whether distribution pressure may be increasing. The user can define:
• Lookback period
• Minimum loss required for a down-day to count
• Volume moving average length
• High-volume factor
• Maximum allowed High-Volume Down-Days
The simplified status box highlights the current setup condition using color:
• Green = strong relative strength and acceptable volume quality
• Yellow = positive or improving relative strength, but not yet ideal
• Red = weak relative strength or too many High-Volume Down-Days
The textbox position, size, width and height can be adjusted in the indicator settings.
This indicator is designed as a decision-support and screening tool for relative strength, pullback quality and German stock leadership analysis. It is not an official IBD RS Rating and does not provide financial advice or automatic buy/sell recommendations. Always combine it with your own chart analysis, risk management and market context. Indicator
Indicator
Ultimate RSIHere is a breakdown of its core features and how they work together:
1. Volatility-Adaptive RSI Length
How it works: Instead of using a static length (like the traditional 14-period RSI), the script calculates the market's standard deviation (volatility).
The Benefit: When the market is highly volatile, the RSI length dynamically shortens, making the indicator more responsive so you can catch quick reversals. When volatility drops (consolidation), the length expands, smoothing the RSI line to filter out "chop" and false signals.
2. Dynamic Overbought / Oversold Zones (Bollinger Bands)
How it works: Standard RSIs use static horizontal lines at 70 and 30. This script applies Bollinger Bands directly to the RSI values themselves.
The Benefit: A reading of 70 isn't always overbought in a strong trend. By wrapping the RSI in a standard deviation channel, you get a dynamic zone. If the RSI breaks above its upper dynamic band, you know momentum is genuinely extreme relative to recent conditions, rather than a fixed arbitrary number.
3. Automated Divergence Detection
How it works: The script constantly scans for discrepancies between price action and RSI momentum.
The Benefit: It automatically plots visual markers on the RSI pane when it detects:
Regular Divergences (Reversals): E.g., Price makes a Lower Low, but RSI makes a Higher Low (Bullish Divergence).
Hidden Divergences (Trend Continuations): E.g., Price makes a Higher Low, but RSI drops to a Lower Low (Hidden Bullish).
4. RSI Moving Average (Signal Line)
How it works: An additional moving average (you can choose between SMA, EMA, RMA, WMA, or HMA) is plotted alongside the RSI.
The Benefit: This acts as a trigger line. An RSI crossing above its EMA can be used as an early entry signal, or as confirmation that momentum has definitively shifted.
5. Multi-Timeframe (MTF) Support
How it works: You can configure the indicator to calculate RSI based on a higher timeframe (e.g., pulling 4-Hour RSI data while you are looking at a 15-minute chart).
The Benefit: This ensures your lower timeframe entries are always aligned with the macro momentum, preventing you from trading against the larger trend.
6. Visual Confluence & Alerts
The RSI line itself is color-coded. For example, it turns bright green when momentum is both above 50 and rising, and dark red when below 50 and falling.
It includes a full suite of alert conditions (divergences and MA crossovers) so you can automate your trading or get pinged when a setup occurs.
In summary, it's designed to replace 3 or 4 different indicators on your chart by giving you adaptive momentum, dynamic exhaustion zones, trend direction, and divergence signals all natively in one branded, professional package. Indicator
RX: Dual RSI Fusion 14/50 Compression Framework## RX: Dual RSI Fusion 14/50 Compression Framework
Is an advanced momentum framework designed to identify potential market exhaustion, compression phases, and high-probability reversal conditions by combining two Relative Strength Index structures into a single analytical model.
Unlike traditional RSI indicators that rely on a single momentum source, this framework integrates both a fast RSI (14-period by default) and a slow RSI (50-period by default) to provide a multi-layer view of market behavior.
### Core Concepts
• **Fast RSI (14):** Captures immediate momentum shifts, short-term exhaustion, and early divergence signals.
• **Slow RSI (50):** Represents the underlying market structure and helps identify broader momentum regimes.
• **Dynamic Compression Engine:** Measures the convergence between moving averages applied to the fast RSI, highlighting periods where momentum becomes increasingly compressed and potentially preparing for expansion.
• **Exhaustion Detection:** The indicator is specifically designed to monitor the sequence of events frequently observed near market turning points, including divergence development, momentum contraction, and structural breakout.
### Features
✔ Dual RSI architecture (Fast + Slow)
✔ Configurable moving averages applied directly to RSI values
✔ Compression detection between fast RSI moving averages
✔ Divergence memory engine with customizable validity period
✔ Momentum Delta histogram (Fast RSI - Slow RSI)
✔ Structural breakout detection from RSI compression zones
✔ Background state visualization for market context
✔ Alert conditions for potential exhaustion breakouts
### Interpretation
The framework is based on the premise that important market reversals are rarely caused by a single event. Instead, reversals often emerge from a succession of conditions:
1. Momentum divergence appears.
2. RSI structure begins to compress.
3. Market enters an exhaustion phase.
4. Fast momentum escapes the compression structure.
5. Expansion begins.
The indicator seeks to visualize this process and provide objective confirmation of potential exhaustion scenarios.
### Notes
This tool should not be interpreted as a standalone buy or sell system. It is intended to be used as a market structure and momentum exhaustion framework, ideally combined with price action, liquidity analysis, volume, or higher timeframe context.
Developed as part of the SXA analytical ecosystem by @Peter_n_n
Indicator
Artemis Adaptive RSI🟦 Artemis Adaptive RSI is a Pine v6 self-tuning RSI workbench. Instead of shipping with a fixed period and fixed thresholds — and forcing the trader to babysit the inputs across regimes (14 / 70 / 30 on stocks, 7 / 80 / 20 on crypto, 21 / 60 / 40 in trends) — a 60-candidate optimisation grid scores Supersmoother-filtered RSI variants against their own forward-return performance on a rolling window, then picks the variant whose threshold trips deliver the cleanest mean-reversion edge on the current market. The active period, smoothing, and OB / OS thresholds update online, and a five-state regime label tells you why the optimiser chose what it chose.
The indicator integrates seven analytical layers — Supersmoother-filtered RSI core, online candidate optimiser, hysteresis-locked regime classifier, Stochastic-Extreme-style multi-band zone visual, pivot-based Regular + Hidden divergence detection with a Smart AI Filter, adaptive trigger markers, theme-adaptive bar painter, and a PRO 8-row dashboard — each operating independently and rendered on a single, clean oscillator panel.
🟦 CREDITS & ATTRIBUTION
The adaptive optimisation CORE — Supersmoother-filtered RSI fleet, rolling-window incremental scorer, champion selection with hysteresis, and the five-state regime classifier — is derived from the open-source work of **GoodBadBitcoin** and published under the same MPL-2.0 license. Full respect to the original author for the design and the open release; this project would not exist without that groundwork.
- Source script — [Adaptive Modern RSI ]()
- Original author — (www.pulsewire.com)
Everything else — the Stochastic-Extreme-style multi-band zone UI, the twelve-theme palette system, the pivot-based divergence engine, the Smart AI Filter, the PRO dashboard, the hover-tooltipped regime badge, the theme-aware bar painter, and the curated nine-channel alert pack — is original work added on top.
🟦 HOW THE CORE ENGINE WORKS
**Supersmoother**
Each bar, the per-bar close change is split into two streams — positive (gains) and negative (losses) — and each stream is fed through an Ehlers two-pole Butterworth low-pass filter. The Supersmoother removes high-frequency noise without piling on the phase lag that naive EMA / RMA pre-smoothing chains accumulate. The filtered gain / loss streams then feed the classical Wilder RSI ratio:
rsi = 100 − 100 / (1 + smoothedGains / smoothedLosses)
**Candidate Fleet**
15 RSI variants are precomputed in parallel — every combination of:
| Axis | Values |
|---|---|
| RSI length | 7 / 10 / 14 / 21 / 28 |
| Supersmoother smoothing | 6 / 10 / 16 |
Combined with 4 threshold tiers (15-85 / 20-80 / 25-75 / 30-70), this gives the 60-slot fleet the optimiser grades against.
**Online Optimiser (Rolling-Edge Scorer)**
Every bar, each of the 60 slots is evaluated:
1. **Trigger detection** — for the slot's threshold pair, did the bar produce an OS-entry (RSI crossed down through OS) or an OB-exit (RSI crossed back down through OB)?
2. **Forward-return scoring** — if a trigger fired, score it by `close / close − 1` (signed by trigger direction).
3. **Rolling bookkeeping** — each slot maintains its own running mean over a sliding `scoreWindow`-bar window. Returns enter on add, exit on subtract, mean recomputed in O(1) per slot per bar — no rescans, no naive sum-of-products drift.
After every bar's update, the slot with the highest mean return wins — subject to two gates:
- **Min Triggers per Candidate** — under-sampled slots are disqualified
- **Switch Margin (%)** — a new champion must beat the current incumbent by this hysteresis margin before it actually takes over
This protects against bar-by-bar leadership flapping when two candidates trade marginal scores.
**Regime Classifier**
The crowned champion's shape (length-index, smoothing-index, level-index, mean-return) is read each bar and the market is tagged as one of five phases:
| Glyph | Phase | Meaning |
|---|---|---|
| ◐ | Adapting | Cold start — optimiser not yet armed (default RSI in use) |
| ✸ | Noisy | Score collapsed, no exploitable edge — sit out |
| ➜ | Trending | Long period + relaxed thresholds — trend dominates, avoid OB/OS reversals |
| ▣ | Range | Short period + strict thresholds — RSI's sweet spot, triggers reliable |
| ⊠ | Calm | Middling parameters — mild swings, use as light confluence |
The raw tag stream is then locked through a two-stage hysteresis machine: the displayed phase only updates after the underlying classification holds for `Regime Confirmation Bars` in a row. This keeps the floating badge from twitching on every minor optimiser jitter.
🟦 MULTI-BAND ZONE UI
A Stochastic-Extreme-style six-band visual at 100 / 80 / 70 / 50 / 30 / 20 / 0. The active OB / OS thresholds overlay as steplines that move as the optimiser updates. Zone fills key off the *adaptive* thresholds so the visual escalation tracks the actual signal logic, not a fixed 70 / 30 line.
The fills are tiered — when the RSI line plus the live champion's mean-return both confirm a zone state, the fill intensifies; otherwise the band shows a lighter tint. The 40 / 60 reference dotted lines and the 50 zero line are decorative — they are NOT the triggers.
**RSI line colour**
| Zone | Colour |
|---|---|
| Above 60 | theme-bull (price-strength bias) |
| Between 40 and 60 | neutral |
| Below 40 | theme-bear (price-weakness bias) |
These 40 / 60 bands are FIXED — they are NOT the adaptive OS / OB. The adaptive thresholds drive the triggers; the 40 / 60 bands just colour the RSI line for at-a-glance bias reading.
🟦 TRIGGER MARKERS
Triangle markers fire at the bar of OS entry / OB exit on the *adaptive* thresholds — the events the optimiser is actually scoring:
- ▲ **OS Entry Trigger** — RSI just crossed down through the adaptive OS threshold (mean-reversion long opportunity)
- ▼ **OB Exit Trigger** — RSI just crossed back down through the adaptive OB threshold from above (rejection / short opportunity)
Markers use `location.absolute` with fixed Y coordinates (10 / 90) so they stay glued to the same visual spot every bar — no drift between candles, no shift when zone fills update. Each visible triangle is paired with an invisible `label.style_circle` carrying a hover tooltip with live RSI value, active threshold, active period, and active smoothing — `plotshape()` does not support tooltips natively, so the dual-track rendering is required for hover content.
🟦 DIVERGENCE DETECTION
Pivot-based detection for the four classical divergence flavours:
| Type | Price | RSI | Signal |
|---|---|---|---|
| Regular Bull (D▲) | Lower Low | Higher Low | Potential reversal up |
| Regular Bear (D▼) | Higher High | Lower High | Potential reversal down |
| Hidden Bull (H▲) | Higher Low | Lower Low | Uptrend continuation |
| Hidden Bear (H▼) | Lower High | Higher High | Downtrend continuation |
Pivots are sampled on raw price (high / low) using `Pivot Arm` bars on each side (symmetric). Each pivot bar's RSI value is read **dynamically from the current active RSI series** via bar-index lookup — so when the optimiser switches champions between pivots, the comparison stays internally consistent (both endpoints come from the SAME series). This is a subtle but critical fix vs. naive divergence ports.
Regular Divergence labels (D▲ / D▼) use bracketed glyphs with solid styling — these are the reversal signals.
Hidden Divergence labels (H▲ / H▼) use the same bracket scheme — these are the continuation signals.
Each label hovers a tooltip with the price change, RSI change, and the pivot bar distance.
**Smart AI Filter**
An optional pre-filter that rejects low-quality divergences before they render. Three independent gates:
1. **Min RSI Swing** — minimum RSI difference between the two pivots (default: 5 points). Drops noise-level differences where RSI barely moved between pivots.
2. **Min Price Swing (%)** — minimum price swing between pivots as a percentage of the recent (80 bars) price range (default: 0.3%). Drops divergences where price barely moved relative to recent volatility.
3. **Zone Confirmation** — RSI at the current pivot must sit in the matching adaptive reversion half:
- Bullish divergence → RSI ≤ midpoint(liveOs, 50) (moderate-to-deep oversold)
- Bearish divergence → RSI ≥ midpoint(50, liveOb) (moderate-to-deep overbought)
The zone gate is adaptive — it tightens or loosens as the optimiser updates the live OS / OB thresholds. This encodes the classical "best divergences form at extremes" rule using the live adaptive thresholds, not a fixed 30 / 70.
When the master toggle is OFF (default), all detected divergences render. When ON, only divergences that clear all three gates survive. The filter applies identically to both chart rendering and alert conditions — no mismatch between visual and alert signals.
🟦 REGIME BADGE
A floating label pinned to the LATEST bar, extending rightward into the chart's right-margin / future area. The `label.style_label_left` style places the arrow tip on the LEFT of the box so it visually "points back" to the active RSI data without overlapping the oscillator line.
The badge shows:
- **Glyph + phase name** (e.g. `▣ Range`)
- **Bars stable** (how long the current phase has held)
- **Action note** (e.g. "RSI's sweet spot — triggers work well")
The background colour pulls from the theme palette — Range = theme-bull tint, Trending = theme-bear tint, Adapting / Noisy = theme-neutral tint, Calm = theme-signal tint — so the badge meaning is reinforced by the palette consistency.
**Hover tooltip**
Hovering the badge surfaces a comprehensive phase legend explaining all five glyphs, what each means, what action to take in each, and how to read the "bars stable" counter.
**Position**
User-selectable: Top (y = 80, upper third), Middle (y = 50, centre, default), Bottom (y = 20, lower third). The Y resolver maps the dropdown onto fixed pane-fraction coordinates so the badge stays parked at the same visual spot regardless of RSI value.
🟦 BAR COLORING
Two mutually exclusive modes apply a state-driven colour to every price bar on the chart:
| Mode | Behavior |
|---|---|
| None | Leave bars untouched (default) |
| RSI Zone | Theme-bear when RSI in OB zone, theme-bull when in OS zone, theme-neutral otherwise |
Uses the *adaptive* OB / OS thresholds, not fixed 30 / 70. The bar painter pulls directly from the active threshold state — when the optimiser switches candidates, the bar colour rule updates accordingly with no lag.
🟦 DASHBOARD
A compact 2-column, 8-row PRO data panel renders on the last bar when enabled. Every value derives from variables already computed upstream, so the dashboard adds zero overhead until the final bar.
| Row | Left | Right |
|---|---|---|
| Header | Artemis A-RSI | ▲ OB / ▼ OS / ■ Neutral (current bias) |
| Phase | Phase | ◐ ✸ ➜ ▣ ⊠ glyph + name (current regime) |
| Period | Period | Active RSI length (e.g. 14) |
| Smooth | Smooth | Active Supersmoother smoothing (e.g. 10) |
| OS Level | OS | Active adaptive OS threshold (e.g. 20) |
| OB Level | OB | Active adaptive OB threshold (e.g. 80) |
| Score | Score | Champion's mean forward return (in %) |
| Last Div | Last Div | Most recent divergence within last 50 bars (D▲ / D▼ / H▲ / H▼ / —) |
**Theme-Adaptive Chrome**
The dashboard auto-inverts its layout based on the active theme:
- **Dark themes** (Tropic, Amber, Pastel, Cyber, Helios, Electric, Candy, Bloomberg, Solar, Royal): header and footer use a faint `thBull` tint, middle rows stay solid dark, text uses full-saturation `thBull`. Border uses `thBull` at 20% transparency for strong theme presence.
- **Light themes** (Midnight, Graphite): backgrounds flip to white, text stays `thBull` (which is itself dark on these themes), border uses `thBull` at 40% transparency.
This guarantees text legibility against every palette without per-theme manual tuning.
**Position & Size**
Six anchor slots (Top / Middle / Bottom × Left / Right) and four text sizes (Tiny / Small / Normal / Large).
🟦 COLOR THEMES
Twelve cohesive palettes, each resolving to four axis colors. The whole script reads through these four variables — nothing below the theme resolver references a raw hex literal, so a single dropdown selection drives every plot, fill, stepline, divergence line, dashboard cell and badge.
| Theme | Character | Bull | Bear |
|---|---|---|---|
| Tropic | Cyan steel + deep orange | #00bcd4 | #ff6d00 |
| Amber | Warm amber + indigo blue | #ff9800 | #e53935 |
| Pastel | Sky blue + soft lavender | #4fc3f7 | #9575cd |
| Cyber | Neon lime + hot crimson | #00e676 | #ff1744 |
| Helios | Bright gold + scarlet | #ffd600 | #ef5350 |
| Electric | Electric aqua + magenta | #00e5ff | #e040fb |
| Candy | Neon green + hot pink | #69F0AE | #FF4081 |
| Bloomberg | Terminal orange + cyan | #ff8c00 | #00b0ff |
| Solar | Solarized olive + crimson | #859900 | #dc322f |
| Royal | Imperial gold + deep purple | #ffd700 | #6a0dad |
| Midnight | Deep navy + dark crimson | #0d47a1 | #b71c1c |
| Graphite | Near-black + silver grey | #1a1a1a | #757575 |
🟦 ALERT SYSTEM
Seven user toggles drive nine alert messages, all using `alert.freq_once_per_bar_close`:
| Toggle | Alert(s) | Condition |
|---|---|---|
| OS Entry Trigger | OS Entry | RSI crossed down through adaptive OS |
| OB Exit Trigger | OB Exit | RSI crossed back down through adaptive OB |
| Regime Change | Phase Flip | Locked regime label updates (post-hysteresis) |
| Regular Divergence | D▲ + D▼ | Reversal divergences detected (respects Smart AI Filter) |
| Hidden Divergence | H▲ + H▼ | Continuation divergences detected (respects Smart AI Filter) |
| RSI Mid Cross Up | Mid ↑ | RSI crossed above 50 |
| RSI Mid Cross Down | Mid ↓ | RSI crossed below 50 |
Each alert fires through `alert()` so the message body carries live context — current RSI value, the active adaptive threshold that triggered, active period and smoothing, and (for Regime Change) the previous phase's hold duration. Divergence alerts respect the Smart AI Filter — if the filter is ON and a divergence is rejected visually, the alert will also not fire.
🟦 SETTINGS REFERENCE
**Visual**
- Theme — 12 palette options. Default: Tropic
**Adaptation Core**
- Optimization Lookback (bars) — 100–1000. Default: 300
- Forward-Return Eval Horizon — 2–20. Default: 5
- Min Triggers per Candidate — ≥ 2. Default: 5
- Switch Margin (%) — 0–50, step 2.5. Default: 10
**Regime Label**
- Show Regime Label — Toggle. Default: ON
- Regime Label Size — Tiny / Small / Normal / Large / Huge. Default: Normal
- Regime Confirmation Bars — 1–100. Default: 10
- Regime Label Position — Top / Middle / Bottom. Default: Middle
**Zones & Levels**
- Show Adaptive Levels — Toggle. Default: ON
- Show Zone Fills — Toggle. Default: ON
- Show Trigger Signals — Toggle. Default: ON
**Divergence**
- Regular Divergence — Toggle. Default: ON
- Regular Opacity — 0–100. Default: 80
- Hidden Divergence — Toggle. Default: ON
- Hidden Opacity — 0–100. Default: 80
- Pivot Arm — 2–50. Default: 5
- Label Size — Tiny / Small / Normal / Large. Default: Tiny
- Smart AI Filter — Master toggle. Default: OFF
- Min RSI Swing — 1.0–50.0. Default: 5.0
- Min Price Swing (%) — 0.1–5.0. Default: 0.3
- Require Zone Confirmation — Toggle. Default: ON
**Bar Coloring**
- Bar Color Mode — None / RSI Zone. Default: None
**Dashboard**
- Show Dashboard — Toggle. Default: ON
- Panel Position — 6 anchor slots. Default: Middle Right
- Panel Text Size — Tiny / Small / Normal / Large. Default: Small
**Alerts**
- OS Entry Trigger — Default: ON
- OB Exit Trigger — Default: ON
- Regime Change — Default: ON
- Regular Divergence — Default: ON
- Hidden Divergence — Default: OFF
- RSI Mid Cross Up — Default: OFF
- RSI Mid Cross Down — Default: OFF
🟦 COMPATIBILITY
Works on all asset classes and all timeframes in PulseWire Pine Script v6.
- Crypto: Spot, futures, perpetual contracts
- Forex: All pairs
- Equities: Stocks, ETFs, indices
- Commodities: Metals, energy, agriculture
- Timeframes: 1m through Monthly
Because the engine self-tunes its RSI period, smoothing, and OB / OS thresholds online, the same default settings work on a 5-second BTC chart and a weekly index chart without retuning. The optimiser sees the asset's actual reversion behaviour and adapts — no per-asset preset library needed.
🟦 TECHNICAL NOTES
- Pine Script v6
- `max_lines_count = 500`, `max_labels_count = 500`, `max_bars_back = 1000`
- No repainting — all values calculated on bar close. Pivot-based divergence results appear `Pivot Arm` bars late by design (standard Pine pivot confirmation behaviour)
- The adaptive RSI line is internally consistent across optimiser switches — divergence pivots read RSI dynamically via `activeRsi `, so both endpoints come from the SAME (current) RSI series even when the champion changes between pivots
- The Supersmoother filter relies on `var float lpY = 0.0` private state per call-site — Pine v6 issues one independent state slot per call-site, so the 15 fleet entries below produce 30 (15 × 2 streams) independent filter histories with zero cross-talk
- Champion switch is hysteresis-gated by `Switch Margin (%)` and an eligibility floor (`Min Triggers per Candidate`) — protects against bar-by-bar flapping when two candidates trade marginal scores
- Regime tag is doubly hysteresis-gated — first the candidate must hold, then the displayed phase only flips after `Regime Confirmation Bars` of stable tagging
- Trigger markers use `location.absolute` with fixed Y coordinates (10 / 90) for visual stability — no slide on zoom or candle-spacing changes
- Trigger marker tooltips piggy-back on invisible `label.style_circle` parallel renders — `plotshape()` does not natively support the `tooltip` argument
🟦 DISCLAIMER
This indicator is provided for educational and informational purposes only. It does not constitute financial advice. Past performance does not guarantee future results. Always conduct your own analysis and apply proper risk management. Indicator
Artemis Wave Oscillator🟦 Artemis Wave Oscillator is a Pine v6 reimagination of the classical WaveTrend family, built on a Welford running-stdev channel and EMA-smoothed normalization. Unlike fixed-band WaveTrend variants that ship with hard-coded levels, the engine continuously rescales itself against its own dispersion — producing a momentum curve that stays perfectly bounded between visually consistent reversion bands on every asset and every timeframe, with no manual recalibration.
The indicator integrates six analytical layers — WaveTrend core, dynamic reversion bands, histogram momentum gauge, extremity reversion dots, regular + hidden divergence detection with a Smart AI Filter, and a theme-adaptive PRO dashboard — each operating independently and rendered on a single, clean oscillator panel.
🟦 HOW THE CORE ENGINE WORKS
**WaveTrend Channel**
Each bar, the engine builds an EMA-smoothed midline from the selected price aggregate over the Channel Length window. In parallel, a Welford single-pass running standard deviation measures the channel width — a numerically stable O(N) algorithm that updates the running mean and squared deviation simultaneously, preserving precision on long histories where naive sum-of-squares accumulators drift.
The raw wave is then computed as:
wave_raw = (src − chanMid) / chanDev × 100
This produces a z-score-like signal scaled to the ±100 range. Dividing by the running standard deviation normalizes the output regardless of asset volatility — BTC, EURUSD, SPY, and a small-cap stock all swing through the same band structure without parameter changes.
**EMA Smoothing**
The raw wave is then passed through an EMA of length Average Length to produce the visible `wave` line. This is the dominant responsiveness control — larger values produce a calmer curve with fewer reversion-zone touches.
**Signal Line**
An SMA of the wave (Signal Length) builds the trigger line. Crossovers between the wave and signal line mark momentum regime changes — the same convention used by classical MACD and Stochastic.
**Histogram**
The wave − signal delta is rendered as a filled area. Two opacity tiers distinguish rising momentum (brighter) from fading momentum (dimmer), so the eye picks up acceleration vs. deceleration at a glance.
**Source Selector**
Nine price aggregates are available:
| Source | Formula | Use case |
|---|---|---|
| Open | open | Open-of-bar bias |
| High | high | Top-of-range tracking |
| Low | low | Bottom-of-range tracking |
| Close | close | Standard, fastest reaction |
| OC2 | (open + close) / 2 | Body midpoint |
| HL2 | (high + low) / 2 | Body-independent midpoint |
| HLC3 | (high + low + close) / 3 | Typical mean — default |
| OHLC4 | (open + high + low + close) / 4 | Smoothest |
| HLCC4 | (high + low + 2×close) / 4 | Close-weighted |
🟦 REVERSION BANDS
The user picks a single Reversion Threshold (T) — the distance from zero (in normalized wave units) beyond which the wave is considered overbought (positive side) or oversold (negative side). Three proportional tiers render automatically:
| Tier | Level | Visual |
|---|---|---|
| Inner | ±T | Outer ring of the gradient fill |
| Middle | ±T × 1.25 | Boundary between outer ring and inner extreme |
| Outer | ±T × 1.5 | Hard outer boundary of the gradient fill |
Because the bands are derived from T, they always wrap the threshold no matter how the user tunes it. A trader scaling T from 80 (volatile assets) to 150 (trending assets) keeps the visual context intact without retuning the band levels.
The Reversion Threshold itself drives three downstream features:
- Extremity Dot triggers
- The "Extremities" bar-coloring mode
- The Dashboard Zone tag (OB / MID / OS)
🟦 EXTREMITY DOTS
OB / OS reversion markers — small dual-layer dots that fire when the wave crosses the signal line beyond the Reversion Threshold:
- **OS dot** (bull theme color) → wave crossed UP past −T
- **OB dot** (bear theme color) → wave crossed DOWN past +T
These are the highest-conviction mean-reversion triggers in the script. The dots use a two-track rendering — a pixel-perfect glow + core visual via `plot.style_circles`, paired with an invisible `label.style_circle` carrying a rich tooltip. Hovering on a dot surfaces:
- Direction (Crossed UP / DOWN through Signal)
- Active zone (Below −T / Above +T)
- Current wave value
- Current signal value
- Trading interpretation (mean-reversion long / short opportunity)
🟦 DIVERGENCE DETECTION
Pivots are calculated using `ta.pivothigh` and `ta.pivotlow` with an arm of `Channel Length / 2`. All divergence results appear `Channel Length / 2` bars late — this is standard Pine Script pivot behavior, not a bug.
**Four divergence types:**
| Type | Price | Wave | Signal |
|---|---|---|---|
| Regular Bull (D▲) | Lower Low | Higher Low | Potential reversal up |
| Regular Bear (D▼) | Higher High | Lower High | Potential reversal down |
| Hidden Bull (H▲) | Higher Low | Lower Low | Uptrend continuation |
| Hidden Bear (H▼) | Lower High | Higher High | Downtrend continuation |
Regular divergence uses solid lines (width 2). Hidden divergence uses dashed lines (width 1) — the thinner, dashed style makes the continuation signal visually quieter than the reversal signal, matching their respective conviction tiers. Labels use bracketed symbols (D▲ / D▼ / H▲ / H▼) and each carries a tooltip-rich hover with price + wave context.
**Smart Divergence Filter (AI)**
An optional pre-filter that rejects low-quality divergences before they render. Three independent gates:
1. **Min Wave Swing** — minimum oscillator swing between the two pivots (default: 5 units). Drops noise-level differences where the wave barely moved between pivots.
2. **Min Price Swing (%)** — minimum price swing between pivots as a percentage of the recent `Channel Length × 4` high-low range (default: 0.3%). Drops divergences where price barely moved relative to recent volatility.
3. **Zone Confirmation** — the wave at the current pivot must sit in the matching reversion half:
- Bullish divergence → wave at LL pivot ≤ −T × 0.5 (oversold half)
- Bearish divergence → wave at HH pivot ≥ +T × 0.5 (overbought half)
This encodes the classical "best divergences form at extremes" rule using the wave value itself as the gate — no MFI or volume input required.
When the master toggle is OFF (default), all detected divergences render. When ON, only divergences that clear all three gates survive. The filter applies identically to both chart rendering and alert conditions — no mismatch between visual and alert signals.
🟦 HISTOGRAM
The wave − signal histogram is rendered as a filled area between the histogram value and the zero line. Two opacity tiers per side:
| State | Color | Opacity |
|---|---|---|
| Bull, rising | thBull | Rising Opacity (default 60) |
| Bull, fading | thBull | Fading Opacity (default 40) |
| Bear, rising | thBear | Rising Opacity (default 60) |
| Bear, fading | thBear | Fading Opacity (default 40) |
Rising bars are the most actionable visual cue — they mark momentum that is accelerating in the active direction. Fading bars indicate momentum stalling.
🟦 BAR COLORING
Five mutually exclusive modes apply a wave-driven color to every price bar on the chart:
| Mode | Behavior |
|---|---|
| None | Leave bars untouched (default) |
| Midline Cross | Bull above zero, bear below zero |
| Extremities | Bull beyond +T, bear beyond −T, neutral elsewhere |
| Reversions | Bull on OS dot trigger, bear on OB dot trigger |
| Slope | Bull when wave > signal, bear when wave < signal |
Colors are pulled from the active theme — no per-mode color picker needed.
🟦 DASHBOARD
A compact 2-column, 7-row data panel renders on the last bar when enabled. Every value derives from variables already computed upstream, so the dashboard adds zero overhead until the final bar.
| Row | Left | Right |
|---|---|---|
| Header | Artemis Wave | ▲ BULL / ▼ BEAR / ■ NEUTRAL |
| Wave | Wave | Current value + trend arrow (▲ ▼ ■) |
| Signal | Signal | Current SMA trigger value |
| Strength | Strength | 10-block monospace bar gauge |
| Zone | Zone | OB / MID / OS tag |
| Div | Div | Most recent divergence within last 50 bars (▲ REG / ▼ REG / ▲ HID / ▼ HID / —) |
| Slope | Slope | ▲ UP / ▼ DOWN / ■ FLAT |
The strength gauge normalizes `|wave − signal|` against 50 (typical mid-amplitude swing) and buckets the result into 10 monospace blocks (`█` filled, `░` empty), giving an at-a-glance read of crossover conviction.
**Theme-Adaptive Chrome**
The dashboard auto-inverts its layout based on the active theme:
- **Dark themes** (Tropic, Amber, Pastel, Cyber, Helios, Electric, Candy, Bloomberg, Solar, Royal): header and footer use a faint `thBull` tint, middle rows stay solid dark, text uses full-saturation `thBull`. Border uses `thBull` at 20% transparency for strong theme presence.
- **Light themes** (Midnight, Graphite): backgrounds flip to white, text stays `thBull` (which is itself dark on these themes), border uses `thBull` at 40% transparency.
This guarantees text legibility against every palette without per-theme manual tuning.
**Position & Size**
Six anchor slots (Top/Middle/Bottom × Left/Right) and four text sizes (Tiny / Small / Normal / Large).
🟦 COLOR THEMES
Twelve cohesive palettes, each resolving to four axis colors:
| Theme | Character | Bull | Bear |
|---|---|---|---|
| Tropic | Cyan steel + deep orange | #00bcd4 | #ff6d00 |
| Amber | Warm amber + indigo blue | #ff9800 | #e53935 |
| Pastel | Sky blue + soft lavender | #4fc3f7 | #9575cd |
| Cyber | Neon lime + hot crimson | #00e676 | #ff1744 |
| Helios | Bright gold + scarlet | #ffd600 | #ef5350 |
| Electric | Electric aqua + magenta | #00e5ff | #e040fb |
| Candy | Neon green + hot pink | #69F0AE | #FF4081 |
| Bloomberg | Terminal orange + cyan | #ff8c00 | #00b0ff |
| Solar | Solarized olive + crimson | #859900 | #dc322f |
| Royal | Imperial gold + deep purple | #ffd700 | #6a0dad |
| Midnight | Deep navy + dark crimson | #0d47a1 | #b71c1c |
| Graphite | Near-black + silver grey | #1a1a1a | #757575 |
All four color roles (bull / bear / neutral / signal) change simultaneously when the theme changes. The whole script reads through these four variables — nothing below the resolver references a raw hex literal, so a single dropdown selection drives every plot, fill, dot, divergence line, dashboard cell and border.
🟦 ALERT SYSTEM
Ten alert conditions, all using `alert.freq_once_per_bar_close`:
| Alert | Condition |
|---|---|
| OS Reversion | Wave crossed UP through signal while wave < −T |
| OB Reversion | Wave crossed DOWN through signal while wave > +T |
| Regular Divergence | D▲ or D▼ detected (respects Smart Filter) |
| Hidden Divergence | H▲ or H▼ detected (respects Smart Filter) |
| Bullish Trend | Wave crossed above the midline (zero) |
| Bearish Trend | Wave crossed below the midline (zero) |
| Bullish Swing | Wave × signal upward cross, regardless of zone |
| Bearish Swing | Wave × signal downward cross, regardless of zone |
Each alert fires through `alert()` so the message body carries live context — direction, current wave value, and the threshold that triggered. Divergence alerts respect the Smart Divergence Filter — if the filter is ON and a divergence is rejected visually, the alert will also not fire.
🟦 SETTINGS REFERENCE
**WaveTrend Core**
- Source — 9 price aggregates. Default: HLC3
- Channel Length — EMA midline + Welford stdev lookback. Default: 10
- Average Length — EMA smoothing of the normalized wave. Default: 21
- Signal Length — SMA smoothing of the wave to build the trigger. Default: 4
**Reversion Bands**
- Reversion Threshold — 50–200, step 5. Default: 100
- Show Band Fills — Toggle. Default: ON
- Band Opacity — 0–100. Default: 30
**Histogram**
- Show Histogram — Toggle. Default: ON
- Rising Opacity — Default: 60
- Fading Opacity — Default: 40
**Extremity Dots**
- Show Extremity Dots — Toggle. Default: ON
**Divergence**
- Regular Divergence — Toggle. Default: ON
- Regular Opacity — Default: 80
- Hidden Divergence — Toggle. Default: ON
- Hidden Opacity — Default: 80
- Label Size — Tiny / Small / Normal / Large. Default: Tiny
- Smart Divergence Filter (AI) — Master toggle. Default: OFF
- Min Wave Swing — Default: 5.0
- Min Price Swing (%) — Default: 0.3%
- Require Zone Confirmation — Default: ON
**Bar Coloring**
- Bar Color Mode — None / Midline Cross / Extremities / Reversions / Slope. Default: None
**Dashboard**
- Show Dashboard — Toggle. Default: ON
- Panel Position — 6 anchor slots. Default: Middle Right
- Panel Text Size — Tiny / Small / Normal / Large. Default: Small
**Alerts**
- OS Reversion — Default: ON
- OB Reversion — Default: ON
- Regular Divergence — Default: ON
- Hidden Divergence — Default: OFF
- Bullish Trend — Default: ON
- Bearish Trend — Default: ON
- Bullish Swing — Default: OFF
- Bearish Swing — Default: OFF
🟦 COMPATIBILITY
Works on all asset classes and all timeframes in PulseWire Pine Script v6.
- Crypto: Spot, futures, perpetual contracts
- Forex: All pairs
- Equities: Stocks, ETFs, indices
- Commodities: Metals, energy, agriculture
- Timeframes: 1m through Monthly
The Welford running standard deviation normalizes the wave against its own dispersion, making the engine fully volatility-agnostic. The same default settings work on a 5-second BTC chart and a weekly index chart without retuning.
🟦 TECHNICAL NOTES
- Pine Script v6
- `max_lines_count = 500`, `max_labels_count = 500` (divergence drawings + extremity dot hover labels)
- No repainting — all values calculated on bar close. Pivot-based divergence results appear `Channel Length / 2` bars late by design
- WaveTrend engine intentionally mirrors EliCobra's original Enhanced WaveTrend formulation — the value added by Artemis Wave is in the Pine v6 idioms, the dynamic band scaling, the divergence engine, the Smart Filter, the theme system, and the dashboard, not in altering the well-tested core curve
- UDT fields declared without defaults to comply with Pine v6's compile-time-literal requirement; objects constructed via `Bar.new(...)` and `WaveReading.new(...)`
- `var int x = int(na)` pattern used for safe persistent integer state (pivot bar indices)
- Reversion-band anchors rendered as hidden `plot()`s rather than `hline()`s — `hline()` only accepts compile-time constants, but the band levels are series values driven by the user-tunable Reversion Threshold
- Extremity Dots use a dual-track rendering: `plot.style_circles` for the pixel-perfect visual, plus a parallel invisible `label.style_circle` carrying the hover tooltip (since `plot()` does not support the `tooltip` argument)
🟦 DISCLAIMER
This indicator is provided for educational and informational purposes only. It does not constitute financial advice. Past performance does not guarantee future results. Always conduct your own analysis and apply proper risk management. Indicator
Elaris Volume Intelligence ProElaris Volume Intelligence Pro is a professional-grade volume analysis and smart money intelligence indicator designed to help traders understand market participation, hidden pressure, and potential reversal activity in real time.
Instead of displaying raw volume alone, Elaris Volume Intelligence Pro transforms market volume into actionable intelligence by combining relative volume analysis, volume delta estimation, CVD (Cumulative Volume Delta), absorption detection, climax activity, and smart flow momentum into a single clean and trader-friendly system.
The indicator is built for discretionary traders, scalpers, intraday traders, swing traders, and crypto traders who want deeper insight into market behavior beyond standard candles.
━━━━━━━━━━━━━━━━━━
FEATURES
━━━━━━━━━━━━━━━━━━
• Smart Volume Columns
Dynamically colored volume bars help identify bullish pressure, bearish pressure, climax activity, and absorption zones instantly.
• Relative Volume & Z-Score Engine
Detects abnormal market participation using relative volume and statistical volume expansion analysis.
• Volume Flow Momentum
A smoothed institutional-style flow model that helps traders identify whether aggressive buying or selling pressure is dominating the market.
• Bullish & Bearish Climax Detection
Highlights potential exhaustion candles during extreme participation and volatility conditions.
• Demand & Supply Absorption Detection
Detects high-volume compression behavior that may indicate hidden accumulation or distribution by larger participants.
• Volume & CVD Divergence Signals
Identifies possible reversal conditions when price action and cumulative volume behavior diverge.
• Smart Market State Dashboard
A clean built-in intelligence panel provides:
* Market bias
* Smart score
* Relative volume strength
* Volume Z-score
* Delta pressure
* Active signal state
• Dark Mode Optimized UI
Professionally designed visuals optimized for both dark and light PulseWire themes.
• Fully Configurable
All thresholds, smoothing values, divergence sensitivity, and visual layers can be customized for different trading styles and markets.
━━━━━━━━━━━━━━━━━━
HOW TO USE
━━━━━━━━━━━━━━━━━━
• Strong Bullish Conditions
Look for:
* Bullish volume climax
* Positive flow momentum
* Increasing relative volume
* Bullish divergences
* Demand absorption
• Strong Bearish Conditions
Look for:
* Bearish climax candles
* Negative flow momentum
* High sell-side pressure
* Bearish divergences
* Supply absorption
• Best Use Cases
* Crypto futures trading
* Intraday momentum trading
* Breakout confirmation
* Reversal detection
* Smart money analysis
* Volume-based confluence systems
━━━━━━━━━━━━━━━━━━
ALERTS INCLUDED
━━━━━━━━━━━━━━━━━━
The indicator includes built-in alerts for:
* Bullish/Bearish Volume Climax
* Demand/Supply Absorption
* Bullish/Bearish Divergence
* Bullish/Bearish Pressure States
━━━━━━━━━━━━━━━━━━
IMPORTANT NOTES
━━━━━━━━━━━━━━━━━━
• This indicator does not use repainting logic.
• Signals are generated using confirmed candle data.
• Works best on liquid markets with reliable volume data.
• Designed for confirmation and confluence, not standalone financial advice.
Built by Elaris Group.
Financial intelligence for modern markets.
Indicator
RSI Optimized with Smoothings & Divergence (RSI Optimized)This indicator enhances the classic RSI by adding multiple smoothing layers, a dynamic background based on the average of six smoothings, an info table, and regular divergence detection.
🔹 **Core RSI**
Standard RSI calculation (Wilder) with fully adjustable length and source. Overbought/oversold levels (70/30) are highlighted with a gradient fill.
🔹 **Smoothing MA**
Optionally apply a moving average to the RSI line (SMA, EMA, SMMA, WMA, VWMA). The "SMA + Bollinger Bands" mode adds Bollinger Bands around the smoothed RSI.
🔹 **Six Smoothings (instead of a ribbon)**
Six independent moving averages of the RSI (customizable type and lengths) are plotted. Useful to visualise multiple timeframes or sensitivities at once.
🔹 **Background color (RSI vs Avg of 6 Smoothings)**
Compares the RSI value to the simple average of the six smoothings. Green background when RSI > average (bullish bias), red when RSI < average (bearish bias).
🔹 **Info Table**
Displays in real time:
- Current RSI value (color‑coded by overbought/oversold)
- Average of the six smoothings
- Ratio = (RSI + Avg)/2
- Trend direction (based on RSI vs average)
- Zone (Oversold / Overbought / Bull / Bear / Neutral)
- Smooth trend (fast smoothing 1 vs upper smoothing 6)
🔹 **Regular Divergences**
Detects regular bullish and bearish divergences between price and RSI. Pivot lookback is fixed to 5 bars left/right. An alert is available for each divergence type.
🔹 **All options are configurable via the Settings tab** – from lengths, colors, smoothing types to enabling/disabling the table or divergences.
📌 **How to use**
- Use the six smoothings to identify trend alignment (e.g., all above 50 = strong uptrend).
- The background turns green when RSI stays above the average of all smoothings.
- Watch for divergence signals (labelled "Bull" / "Bear") for potential reversals.
- The info table gives a quick snapshot of momentum and trend state.
This tool is ideal for traders who want a richer RSI experience without cluttering the chart.
NOTE PERSO :THANK TRADING VIEW FOR YOU WORKS , YOU ARE BEST !!! & ENJOY TEAM TRADING VIEW MAKE PEACE NOT WARS !!! STAY TUNED !! Indicator
Climax Volume Reversal Radar
Detecting abnormal volume spikes that may signal exhaustion, capitulation, or reversal pressure.
Climax Volume Reversal Radar is a volume-based exhaustion indicator designed to highlight abnormal volume spikes that may occur near potential short-term reversal zones.
The indicator compares current volume against a recent average volume baseline and marks bars when volume expands above a user-defined risk multiplier.
It focuses on two types of potential climax events:
Bullish Climax Condition:
Detected when price is trading below its previous reference close, the candle closes bearish, and current volume is significantly above average. This may represent aggressive selling pressure, possible capitulation, or a potential bullish reversal watch zone.
Bearish Climax Condition:
Detected when price is trading above its previous reference close, the candle closes bullish, and current volume is significantly above average. This may represent aggressive buying pressure, possible exhaustion, or a potential bearish reversal watch zone.
The indicator also includes an optional volume moving average to help traders compare current activity against normal participation levels.
This tool can be useful for identifying:
- Volume climaxes
- Potential exhaustion points
- Possible capitulation zones
- Abnormal market participation
- Short-term reversal watch areas
- High-volume emotional candles
Best used with support and resistance, VWAP, trend structure, liquidity zones, or price action confirmation. This indicator does not predict reversals automatically and should not be used as a standalone trading system.
How it works:
The indicator calculates an average volume baseline using recent bars and compares the current volume against that baseline.
When current volume exceeds the average by the selected multiplier, the script checks whether price is moving aggressively upward or downward.
A high-volume bearish candle may suggest selling climax or capitulation.
A high-volume bullish candle may suggest buying climax or exhaustion.
These events do not guarantee a reversal. They are best interpreted as warning zones where emotional market participation may be increasing.
Inputs:
Show MA:
Enables or disables the volume moving average.
Length MA:
Controls the length of the volume moving average.
Taking Close:
Defines how many bars back the script uses as the reference close for directional comparison.
Risk Factor:
Controls how much current volume must exceed average volume before a climax condition is detected. Higher values create fewer but stronger signals.
Limitations:
- A climax volume bar does not guarantee a reversal.
- Strong trends can continue after a volume spike.
- Signals may appear late if the exhaustion move is already extended.
- The indicator does not include trend filters, stops, targets, or confirmation logic.
- Volume data may vary across assets, brokers, and markets. Indicator
Elaris RSI Pro [Divergence]Elaris RSI Pro is a professional-grade RSI momentum and divergence indicator built for traders who want cleaner market structure signals, smarter divergence detection, and a more refined trading workflow.
The indicator combines a responsive RSI engine with advanced bullish and bearish divergence detection to help identify potential reversals, continuation setups, and momentum shifts across all market conditions.
Designed with a clean visual experience and optimized performance in mind, Elaris RSI Pro delivers clear signals without unnecessary chart clutter, making it suitable for scalpers, swing traders, and intraday traders alike.
Key Features:
• Regular Bullish & Bearish Divergence Detection
• Hidden Bullish & Bearish Divergence Detection
• Configurable Pivot Detection Engine
• Adjustable Minimum & Maximum Pivot Distance Filters
• Dynamic RSI Momentum Coloring
• Signal Smoothing with EMA Filter
• Overbought / Oversold Zone Visualization
• Optional Divergence Lines & Labels
• Optional Pivot Markers for Advanced Analysis
• Professional Alert Conditions
• Non-Repainting Confirmed Pivot Logic
• Optimized Object Management for Better Performance
Elaris RSI Pro is built using confirmed pivot logic, meaning divergence signals are generated only after pivot confirmation to reduce repainting behavior and improve signal reliability.
The indicator is highly customizable, allowing traders to adapt the sensitivity and visual behavior to different trading styles, markets, and timeframes.
Works well with:
• Market Structure Analysis
• Trend Following Systems
• Support & Resistance Trading
• Smart Money Concepts (SMC)
• Liquidity Sweep Confirmation
• Multi-Timeframe Confluence Strategies
Best used alongside proper risk management and confirmation tools.
Non-Repainting:
This indicator uses confirmed pivot-based calculations. Signals appear only after pivot confirmation and do not repaint historically after confirmation. Indicator
Cross Exchange Premium Drift Map [AGPro Series]Cross Exchange Premium Drift Map
🧠 Core Idea
Is the active crypto venue drifting away from the exchange basket, or is the market staying aligned across venues?
📌 Overview / What it does
Cross Exchange Premium Drift Map is a crypto market structure tool designed to compare the active chart against a configurable basket of exchange reference symbols.
Instead of reading only the local chart, the script builds a venue basket from multiple exchange feeds and measures whether the active venue is trading at a premium, discount, or neutral alignment versus that basket.
It produces a premium drift path, a dispersion path, a right-side venue premium stack, event labels, strongest/weakest venue context, and a compact panel. It does not predict price direction, automate trading, or claim that a premium will close immediately.
🎯 Purpose & Design Philosophy
This script was built to fill a specific gap in crypto analysis: many traders look at one exchange chart and assume that chart represents the whole market.
Crypto is fragmented across venues. Premiums, discounts, and venue dispersion can appear before important shifts in liquidity, risk appetite, or execution quality.
The purpose of this tool is to make that fragmentation visible in a structured, readable, and non-predictive way.
⚡ Why This Script Is Different
Most tools focus on the active chart alone, or compare futures against spot using a basis model.
This script does NOT operate as a funding, carry, open interest, or perp-versus-spot basis indicator.
Instead, it compares the active venue against a configurable cross-exchange reference basket, then maps premium drift, venue dispersion, strongest venue, weakest venue, and alignment quality into a dedicated visual workflow.
⚙️ Methodology
1. Venue Basket Construction
The script requests multiple user-defined exchange symbols and builds an average reference basket from available venue prices.
2. Premium Drift Detection
The active chart is compared against the venue basket to calculate premium or discount.
3. Dispersion Evaluation
The script measures how far individual venues are spread around the basket.
4. State Classification
Premium, discount, spread expansion, spread compression, and exchange alignment are converted into readable states.
5. Visual Output
The chart displays premium paths, event labels, a right-side venue stack, and a panel summary.
🗺️ How to Read the Chart
The premium drift path shows how the active chart behaves relative to the venue basket.
The dispersion path shows whether exchange prices are widening away from each other or compressing toward alignment.
The right-side venue stack shows the current premium/discount context, basket drift, dispersion, strongest venue, and weakest venue.
Labels mark meaningful changes such as Venue Premium, Venue Discount, Spread Expansion, and Exchange Alignment.
The panel summarizes state, score, premium, drift z-score, velocity, dispersion, direction, grade, and venue count.
🚦 Signals & States
• Venue Premium → the active chart trades meaningfully above the exchange basket
• Venue Discount → the active chart trades meaningfully below the exchange basket
• Spread Expansion → venue dispersion is widening
• Spread Compression → venue prices are moving closer together
• Exchange Alignment → venues are compressed and the active chart is near the basket
• Check Venue Set → selected symbols may not represent the same asset or may be mismatched
🔔 Alerts Logic
Alerts trigger when the script detects a fresh state transition into a meaningful venue condition.
Venue Premium alerts mark active-chart premium pressure versus the basket.
Venue Discount alerts mark active-chart discount pressure versus the basket.
Spread Expansion alerts mark widening cross-exchange dispersion.
Exchange Alignment alerts mark compression toward venue agreement.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest readings occur when premium drift, drift z-score, velocity, dispersion, and persistence align.
When these conditions align, the venue message becomes more meaningful, but it still remains context rather than a prediction.
📊 When to Use
• Crypto spot charts with active multi-exchange liquidity
• BTC, ETH, and major liquid altcoin pairs
• Periods where venue premium, discount, or spread quality matters
• Market structure review before interpreting local price action
• Cross-exchange monitoring during volatile sessions
⚠️ When NOT to Use
• Illiquid symbols with unreliable venue references
• Symbols where the basket does not match the active chart asset
• Extremely noisy low-timeframe conditions
• Markets where one or more venue feeds are missing or stale
• Situations where the user expects guaranteed arbitrage signals
🎛️ Key Inputs
• Venue Symbols → define the exchange reference basket
• Venue Labels → control the short exchange names shown in the visual stack
• Premium Threshold → controls when active-chart premium or discount becomes relevant
• Dispersion Threshold → controls when cross-exchange spread widening matters
• Premium Baseline Length → controls the drift baseline
• Premium Z-Score Length → controls normalization
• Visual Settings → control panel, labels, paths, and venue stack display
🖥️ Interface & Visual Design
The interface is built for quick market reading.
The panel provides compact state information.
The premium stack shows the current venue relationship without using pale or white primary visuals, preserving readability on both dark and light chart backgrounds.
Labels are designed to be visible, premium, and not buried inside candles.
🧪 Practical Usage Workflow
1. Confirm that the venue symbols match the active chart asset.
2. Read the panel state and score.
3. Check whether the active chart is premium, discount, aligned, or mismatched.
4. Inspect the strongest and weakest venue labels.
5. Use the premium and dispersion paths to understand whether the relationship is widening or normalizing.
🔍 Interpretation Guidelines
A venue premium does not automatically mean price must fall.
A venue discount does not automatically mean price must rise.
Spread expansion means exchange prices are becoming less aligned.
Exchange alignment means the active venue is closer to the basket.
The script should be read as market context, not as a buy or sell system.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an arbitrage execution tool.
It is not an auto-trading system.
It does not guarantee that premiums, discounts, or spreads will normalize.
⚠️ Limitations & Transparency
Cross-exchange readings depend on symbol quality, venue availability, quote currency differences, and PulseWire data access.
USD and USDT references may behave slightly differently.
Low-liquidity assets can produce unstable readings.
Timeframe differences and exchange data behavior can affect how states appear.
🧠 Market Context Notes
Crypto markets are fragmented.
The same asset can trade differently across exchanges because of liquidity, regional flow, quote currency differences, venue-specific demand, and execution conditions.
This script attempts to make that fragmentation easier to see.
🧾 Use Case Examples
When the active chart trades above the basket while dispersion expands, the market may be showing venue-specific premium pressure.
When the active chart trades below the basket while dispersion expands, the market may be showing local venue weakness.
When premium and dispersion compress together, the market may be returning toward exchange alignment.
🧱 System Philosophy
Cross Exchange Premium Drift Map follows the AGProLabs design principle of building decision-support maps rather than prediction tools.
The goal is to improve context, visual structure, and trader awareness.
🔐 Non-Promise Statement
No signal in this script guarantees a future price move.
No premium or discount reading guarantees convergence.
All outputs require broader market interpretation.
📉 Risk Disclosure
Trading involves risk.
Users are fully responsible for their own decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
This tool is designed for educational and analytical use. It helps traders study cross-exchange price behavior, venue alignment, and premium drift as part of a broader market structure workflow.
Indicator
Crypto Beta Leadership Ladder [AGPro Series]Crypto Beta Leadership Ladder
🧠 Core Idea
When crypto risk appetite changes, who is actually leading the move: BTC, ETH, broad alt beta, or the active chart itself?
📌 Overview / What it does
Crypto Beta Leadership Ladder is a market leadership and relative beta map for crypto traders.
The script compares BTC, ETH, broad altcoin market-cap behavior, high-beta altcoin breadth, BTC dominance, ETH dominance, and the active chart into a single leadership framework.
It produces a right-side leadership ladder, a live leadership path, selective transition labels, optional compact markers, and an AG Pro dashboard panel. It does not predict price, automate trades, or tell users what to buy or sell.
🎯 Purpose & Design Philosophy
This script was built to solve a common crypto-market problem: price may move, but leadership often rotates underneath the move.
Sometimes BTC is leading defensively. Sometimes ETH begins to participate. Sometimes broad alt beta expands. Sometimes the active chart is outperforming the market. These are different market conditions, and they should not be interpreted the same way.
The goal is to help traders read crypto leadership quality instead of reacting only to candle direction.
⚡ Why This Script Is Different
Most tools focus on one symbol, one moving average, one dominance chart, or one relative-strength line.
This script does NOT draw liquidation zones, funding stress maps, stablecoin liquidity pulses, basis corridors, or open-interest commitment zones.
Instead, it builds a leadership ladder from multiple crypto-market proxies and ranks BTC, ETH, alt beta, and chart beta as a live market hierarchy.
⚙️ Methodology
1. Context Detection
The script reads BTC, ETH, TOTAL2, TOTAL3, BTC dominance, and ETH dominance sources.
2. Relative Beta Mapping
It compares performance, dominance change, chart beta versus BTC, and altcoin breadth versus BTC.
3. Leadership Ranking
BTC, ETH, ALT, and CHART scores are ranked into a leadership stack. The gap between the first and second rank controls whether leadership is clear or split.
4. Visual Output
The script displays a right-side rank ladder, a leadership path, selective event labels, optional rank markers, and a compact dashboard.
🗺️ How to Read the Chart
The top ladder rail shows the current leadership rank.
The middle rail shows the second rank and whether leadership is close or split.
The lower rail shows the third rank and the active beta spread context.
The leadership path moves with the market and changes color by active leadership state.
Event labels highlight major transitions such as BTC Shield Lead, ETH Leadership, Alt Beta Lead, Chart Beta Expansion, or Split Leadership.
The panel summarizes leader, score, edge, BTC relative change, ETH relative change, alt beta, chart beta, dominance shift, persistence, state, and grade.
🚦 Signals & States
• BTC Leadership → BTC is leading defensively versus the broader crypto market
• ETH Leadership → ETH participation is stronger than BTC and broad alt context
• Alt Beta Lead → high-beta altcoin breadth is leading the crypto market
• Chart Beta Expansion → the active chart is outperforming BTC with expanding beta
• Split Leadership → leadership is mixed and no single group has clear control
• Balanced Leadership → leadership is present but not strong enough to be dominant
• Data Missing → one or more reference sources are unavailable
🔔 Alerts Logic
Alerts can be enabled for BTC Leadership, ETH Leadership, Alt Beta Leadership, Chart Beta Expansion, and Split Leadership.
Alerts trigger when the relevant state becomes active and the leadership state changes.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The ladder becomes more meaningful when rank edge, dominance shift, chart trend, and persistence align.
For example, an Alt Beta Lead state with positive chart beta and falling BTC dominance suggests a stronger risk-on leadership environment than a single isolated altcoin move.
📊 When to Use
• Crypto market rotation analysis
• BTC versus altcoin leadership checks
• ETH participation monitoring
• Altcoin beta expansion environments
• Market regime comparison across timeframes
⚠️ When NOT to Use
• Symbols with poor liquidity
• Very low timeframes with noisy dominance behavior
• Markets where reference symbols are unavailable
• During extreme news shocks without broader context
🎛️ Key Inputs
• Leadership Momentum Length → controls the main comparison window
• Leadership Baseline Length → controls slower leadership context
• Leadership Edge Threshold → controls how strong rank separation must be
• Beta Expansion Threshold → controls chart outperformance sensitivity
• Ladder Projection Bars → controls right-side ladder length
• Label Font Size / Panel Font Size → controls visual readability
🖥️ Interface & Visual Design
The interface is designed as a leadership stack rather than a zone map.
The ladder avoids white or pale-gray primary visuals so it remains visible on both dark and light chart backgrounds.
The panel uses the AG Pro blue header with a single merged title row and a compact information hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check which asset group leads the ladder.
3. Compare edge and persistence.
4. Read the leadership path color.
5. Use event labels as attention markers, not trade signals.
🔍 Interpretation Guidelines
Clear leadership means one group is controlling relative market behavior.
Split leadership means the market may be rotating, pausing, or lacking conviction.
Chart Beta Expansion means the active symbol is outperforming BTC, but it still requires broader confirmation.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a financial-advice tool.
It is not an automated trading system.
It does not guarantee that leadership will continue.
It does not replace risk management or broader market analysis.
⚠️ Limitations & Transparency
Reference-symbol availability may vary by exchange, region, and PulseWire data feed.
Dominance data may behave differently from exchange-traded pairs on lower timeframes.
Leadership can rotate quickly during volatile crypto sessions.
Different timeframes may show different leadership states.
🧠 Market Context Notes
BTC leadership often reflects defensive crypto behavior.
ETH leadership can suggest higher participation in major smart-contract assets.
Alt beta leadership can suggest broader risk appetite, but it may also be more volatile.
Split leadership often appears during transitions, pauses, or uncertain market regimes.
🧾 Use Case Examples
When BTC leads while BTC dominance rises, the market may be defensive even if price is moving.
When alt beta leads while BTC dominance falls, broader risk appetite may be improving.
When the active chart expands versus BTC while rank edge improves, that symbol may deserve closer attention.
🧱 System Philosophy
Crypto markets are not led by one chart all the time.
This script treats leadership as a rotating hierarchy and visualizes that hierarchy directly on the chart.
🔐 Non-Promise Statement
No script can guarantee future price behavior.
This tool maps leadership context; it does not provide certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions.
This script is provided for educational and analytical purposes only and does not constitute financial advice.
📚 Educational Note
Use the ladder to study how crypto leadership rotates between BTC, ETH, alt beta, and the active chart across different market regimes.
Indicator
Relative Strength Pullback Map [AGPro Series]Relative Strength Pullback Map
🧠 Core Idea
Is the pullback happening while the asset remains a relative leader against its benchmark?
📌 Overview / What it does
Relative Strength Pullback Map is a benchmark-relative price-action tool built to study whether an asset is pulling back from strength or breaking down into weakness.
The script compares the active symbol against a selected benchmark, builds a relative-strength baseline, evaluates leader status, measures pullback depth, maps a pullback pocket, marks the recovery rail, and summarizes the full context inside a compact AG Pro panel.
It does not predict future price, automate trades, or claim that every leader pullback must recover. It is a structured decision-support map for reading relative strength, benchmark leadership, pullback health, recovery readiness, and relative breakdown risk.
🎯 Purpose & Design Philosophy
Pullbacks are not all equal.
Some pullbacks happen while the asset continues to outperform its benchmark.
Other pullbacks happen because relative strength is already breaking down.
This script was built to separate those two conditions. The design goal is to help traders identify whether a pullback belongs to a still-strong relative leader or a weakening laggard.
⚡ Why This Script Is Different
Most pullback tools focus only on price.
Most relative-strength tools focus only on the ratio line.
This script does NOT treat pullback quality and relative strength as separate ideas.
Instead, it combines benchmark-relative leadership, price pullback depth, trend shelf behavior, recovery rail reclaim, and relative breakdown risk into one visual map.
The focus is not only whether price pulled back.
The focus is whether the asset remained a leader while pulling back.
⚙️ Methodology
1. Benchmark Comparison
The script compares the active symbol against a selected benchmark using a relative-strength ratio.
2. Relative Strength Baseline
The ratio is smoothed into a baseline so leadership can be evaluated against its own recent behavior.
3. Leader Status Scoring
Leader status combines relative-strength distance, relative-strength slope, and price trend structure.
4. Pullback Depth Measurement
The script measures how far price has pulled back from the recent high using ATR-normalized depth and percentage depth.
5. Pullback Pocket Mapping
The pullback pocket is mapped between the fast recovery rail and the deeper trend shelf.
6. Recovery Evaluation
The script checks whether price is reclaiming the recovery rail while relative strength remains constructive.
7. Visual Output
The chart displays the pullback pocket, recovery rail, relative-strength rail, leader/laggard labels, right-side context tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Relative Pullback Pocket = the area where a leader pullback can remain structurally constructive.
Recovery Rail = the fast trend rail used to evaluate whether price is starting to recover from the pullback.
RS LEADER tag = the active symbol is outperforming the selected benchmark with constructive relative strength.
PULLBACK tag = the current pullback depth measured in ATR.
LEADER PULLBACK = the asset remains a relative leader while pulling into a meaningful pullback area.
RS HOLD = relative strength remains constructive during the pullback.
RECOVERY READY = price reclaimed the recovery rail while relative strength remained constructive.
RS BREAK = relative strength weakened or price broke the deeper pullback shelf.
Panel = summarizes relative state, quality score, leader status, pullback depth, recovery trigger, benchmark, and next context.
🚦 Signals & States
• LEADER PULLBACK → the asset remains a relative leader while pulling back.
• RS HOLD → relative strength is still holding during the pullback.
• RECOVERY READY → price reclaimed the recovery rail with constructive relative strength.
• RS BREAK → relative strength weakened or the pullback shelf broke.
• LAGGARD RISK → price is pulling back while the asset is no longer a clear relative leader.
🔔 Alerts Logic
Alerts can trigger when a leader pullback appears, relative strength holds, recovery becomes ready, or relative breakdown appears.
These alerts are attention markers only.
They are not trade instructions, entry signals, exit signals, or guaranteed outcomes.
🧩 Confluence Logic
The context becomes stronger when the active symbol remains above its relative-strength baseline, relative-strength slope is constructive, pullback depth is meaningful but not too deep, and price starts reclaiming the recovery rail.
The context becomes weaker when relative strength drops below its baseline, the slope turns down, or price breaks below the deeper trend shelf.
📊 When to Use
• During trend pullbacks
• When comparing an asset against a benchmark
• In crypto rotation analysis
• In stock or ETF relative-strength review
• When looking for leader pullbacks rather than weak pullbacks
• When filtering pullbacks by benchmark-relative performance
⚠️ When NOT to Use
• On symbols with poor benchmark fit
• During extremely noisy sideways markets
• In low-liquidity markets with unreliable candles
• When benchmark data is missing or unsuitable
• As a standalone buy or sell system
🎛️ Key Inputs
• Benchmark Symbol → defines the market used for relative comparison.
• Relative Strength Baseline → controls the smoothing length of the RS ratio.
• RS Slope Lookback → controls how relative-strength direction is evaluated.
• Minimum Leader Score → controls how strict leader classification should be.
• Fast Trend Length → controls the recovery rail.
• Slow Trend Length → controls the deeper pullback shelf.
• Pullback Lookback → controls the recent high used to measure pullback depth.
• Maximum Healthy Pullback ATR → controls when a pullback becomes too deep.
• Label and Panel Font Size → controls chart readability.
🖥️ Interface & Visual Design
The visual design is built around one question:
Is this still a leader pullback?
The pullback pocket shows the structural area, the recovery rail marks the reclaim reference, the relative-strength rail keeps benchmark context visible, the labels mark state changes, and the AG Pro panel summarizes the current decision context.
🧪 Practical Usage Workflow
1. Select an appropriate benchmark.
2. Read the panel first.
3. Check whether the asset is a relative leader.
4. Review pullback depth.
5. Look at the pullback pocket.
6. Watch whether price reclaims the recovery rail.
7. Confirm the broader market structure independently.
🔍 Interpretation Guidelines
A leader pullback means the asset is pulling back while still holding relative strength.
An RS hold means relative leadership has not broken yet.
Recovery ready means price has started reclaiming the recovery rail while relative strength remains constructive.
An RS break means the pullback may no longer be a clean leader pullback.
None of these states guarantee what happens next.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a financial advice tool.
It is not an automated trading system.
It does not guarantee recovery after a leader pullback.
It does not guarantee that relative leaders will continue outperforming.
It does not replace risk management or independent analysis.
⚠️ Limitations & Transparency
Relative strength depends heavily on benchmark selection.
Different benchmarks may produce different interpretations.
Different timeframes may show different relative-strength states.
Fast markets can move through the pullback pocket quickly.
Sideways markets may create unclear relative-strength readings.
🧠 Market Context Notes
Relative strength is most useful when combined with structure, trend, volatility, and market regime.
A pullback in a relative leader can be constructive if leadership remains intact.
A pullback with relative breakdown is a weaker context and should be interpreted with caution.
Benchmark choice matters: crypto pairs may use BTCUSDT, stock charts may use SPY, sector ETFs, or another relevant benchmark.
🧾 Use Case Examples
When ETH pulls back while still outperforming BTC, the script can identify whether the pullback remains constructive or starts losing relative strength.
When a stock pulls back against SPY but relative strength holds above baseline, the script can highlight a leader pullback context.
When price breaks the pullback shelf while RS weakens, the script can flag relative breakdown risk.
🧱 System Philosophy
Relative Strength Pullback Map is part of the AGPro Series approach:
Build visual tools that explain market context clearly, avoid hype, avoid prediction claims, and support structured decision-making.
The goal is not to tell users what to do.
The goal is to help users see whether a pullback belongs to a strong leader or a weakening asset.
🔐 Non-Promise Statement
No script can remove uncertainty from trading.
This tool does not promise accuracy, certainty, profitability, or future performance.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly.
Users are responsible for their own decisions, position sizing, risk management, benchmark selection, and interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this script as a structured way to study relative strength, benchmark leadership, pullback depth, and recovery context.
The most valuable output is not a single label.
The value is the full map: relative state, leader status, pullback pocket, recovery rail, and next context.
Indicator
Volume Participation Shock Map [AGPro Series]Volume Participation Shock Map
🧠 Core Idea
Did the volume shock bring real participation, or did the move get absorbed after the first impulse?
📌 Overview / What it does
Volume Participation Shock Map is a volume-flow interpretation tool designed to study what happens after a major participation candle appears.
The script identifies high-quality volume shocks by combining relative volume, candle body participation, ATR-adjusted range expansion, and close location. It then projects the active shock zone, tracks follow-through, detects absorption risk, highlights thin continuation attempts, and summarizes the current participation state in an AG Pro panel.
It does not predict price direction, automate trades, or claim that every high-volume candle will continue. It is a structured visualization tool for reading participation quality after volume events.
🎯 Purpose & Design Philosophy
Many volume tools stop at the first spike.
This script was built to answer the next question:
Did the market continue to participate after the shock, or was the impulse absorbed?
The design goal is to help traders separate meaningful volume expansion from one-bar excitement, thin breakouts, and failed participation.
⚡ Why This Script Is Different
Most tools focus on volume spikes, climax candles, or simple high-volume alerts.
This script does NOT treat high volume as automatically bullish or bearish.
Instead, it checks whether the candle had real body participation, whether price followed through beyond the shock zone, whether the move was absorbed back through the zone, and whether later breakouts happened with weak participation.
⚙️ Methodology
1. Shock Detection
The script compares current volume with recent average volume, checks candle body share, evaluates ATR-adjusted range expansion, and scores close location.
2. Shock Zone Mapping
When a qualified shock appears, the candle range becomes an active participation shock zone.
3. Follow-Through Evaluation
After the shock, the script watches whether price accepts beyond the shock high or low with enough relative volume.
4. Absorption Evaluation
If price closes back through the shock zone after the impulse, the script can mark absorption risk.
5. Visual Output
The chart displays the active shock zone, midpoint participation rail, event labels, right-side context tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Participation Shock Zone = the active high-volume candle range being evaluated.
Participation Rail = the midpoint of the shock zone.
BULL VOLUME SHOCK = a bullish shock candle with strong volume, body participation, and range expansion.
BEAR VOLUME SHOCK = a bearish shock candle with strong volume, body participation, and range expansion.
REAL FLOW CONTINUATION = price followed through beyond the shock zone with acceptable participation.
ABSORPTION RISK = price moved back through the shock zone after the initial impulse.
THIN MOVE = price moved beyond the shock edge without enough relative volume. This appears in Detailed label mode.
Panel = summarizes participation state, quality score, shock type, relative volume, body participation, follow-through, absorption risk, and next context.
🚦 Signals & States
• BULL VOLUME SHOCK → bullish high-participation impulse appeared.
• BEAR VOLUME SHOCK → bearish high-participation impulse appeared.
• REAL FLOW UP → bullish shock followed through with acceptable participation.
• REAL FLOW DOWN → bearish shock followed through with acceptable participation.
• BULL SHOCK ABSORBED → bullish shock lost participation back through the zone.
• BEAR SHOCK ABSORBED → bearish shock lost participation back through the zone.
• SHOCK WATCH → an active shock is still being evaluated.
• QUIET FLOW → no active participation shock is currently dominant.
🔔 Alerts Logic
Alerts trigger when a major participation state appears.
• Volume Participation Shock → a high-quality volume shock appears.
• Real-Flow Continuation → price follows through beyond the active shock zone with acceptable participation.
• Absorption Risk → price closes back through the active shock zone after the shock.
• Thin Move → price moves beyond the shock edge without enough relative volume.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• Relative volume is clearly above normal
• Candle body participation is strong
• Candle range expands versus ATR
• Price closes near the directional side of the candle
• Follow-through appears before the evaluation window expires
• The panel state agrees with the chart label
If these elements do not align, the script avoids treating volume as automatic conviction.
📊 When to Use
• Breakout participation review
• Trend continuation validation
• Reversal impulse analysis
• High-volume candle interpretation
• Futures, stocks, forex, crypto, and liquid markets
• 15m, 30m, 1H, 4H, and 1D charts where volume data is meaningful
⚠️ When NOT to Use
• Symbols with unreliable or missing volume data
• Very low-liquidity markets
• Extremely noisy micro timeframes
• News spikes where volume behavior may be abnormal
• Markets where candle volume does not represent real participation well
• Situations where a single volume event should not be over-interpreted
🎛️ Key Inputs
• Relative Volume Length → defines the volume baseline.
• Shock Relative Volume → sets how strong volume must be before a shock can qualify.
• Minimum Body Participation % → controls how much candle body commitment is required.
• Minimum Range ATR → filters out small candles with high volume.
• Shock Quality Threshold → controls how selective the main shock labels are.
• Follow-Through Window → defines how long after a shock the script watches for continuation or absorption.
• Minimum Follow Relative Volume → defines whether continuation has enough participation.
• Absorption Midline Threshold % → controls how deeply price must return into the shock zone before absorption risk is marked.
• Event Label Mode → Premium focuses on major shock, continuation, and absorption events. Detailed also allows thin-move labels.
🖥️ Interface & Visual Design
The visual hierarchy is built around the active shock zone.
The zone shows the high-volume impulse range.
The midpoint rail helps judge acceptance versus absorption.
Event labels highlight the most important participation behavior.
Right-side tags keep the current shock context visible.
The AG Pro panel compresses the current state into a fast, readable decision-support summary.
🧪 Practical Usage Workflow
1. Read the panel participation state.
2. Check whether an active shock zone is present.
3. Watch whether price accepts beyond the shock high or low.
4. Evaluate whether follow-through has enough relative volume.
5. Watch for absorption back through the shock zone.
6. Confirm the chart context with structure, trend, liquidity, and risk planning.
🔍 Interpretation Guidelines
A volume shock is not automatically a valid trade signal.
Continuation is stronger when price accepts beyond the shock zone with participation.
Absorption matters when the first impulse cannot hold its zone.
Thin moves can warn that price is extending without enough participation.
The script is best used as a participation-reading layer, not as a standalone decision system.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a simple volume spike alert.
⚠️ Limitations & Transparency
Volume quality depends on the symbol and market.
Crypto, futures, stocks, and forex may represent volume differently.
High volatility can create sudden shock labels that need broader context.
Low-liquidity assets may produce misleading relative volume readings.
Different timeframes may show different participation behavior.
🧠 Market Context Notes
Volume can be useful only when it is read together with price behavior.
A strong candle with high volume may show participation.
But if price cannot follow through, that same candle may become an absorption reference.
This script is designed to make that difference easier to see.
🧾 Use Case Examples
If a strong bullish candle appears with high relative volume, large body participation, and range expansion, the script may mark BULL VOLUME SHOCK.
If price later closes above the shock high with enough participation, the script may mark REAL FLOW CONTINUATION.
If price closes back through the shock zone after the impulse, the script may mark ABSORPTION RISK.
If price breaks beyond the shock edge with weak relative volume, Detailed mode may mark THIN MOVE.
🧱 System Philosophy
The goal is not to make volume louder.
The goal is to make volume behavior more interpretable.
This script treats participation as a sequence:
shock → acceptance → follow-through → absorption or continuation.
🔐 Non-Promise Statement
No script can guarantee market direction.
No volume event guarantees continuation.
No absorption label guarantees reversal.
All outputs should be interpreted as analytical context.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical purposes only.
It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are fully responsible for their own decisions, risk management, and trade execution.
📚 Educational Note
Use the script to study how markets behave after high-participation candles.
The most important question is not only whether volume appeared.
The better question is whether price continued to accept that participation afterward.
Indicator
Order Flow Imbalance Recovery Planner [AGPro Series]Order Flow Imbalance Recovery Planner
🧠 Core Idea
Can a high-volume displacement pocket recover with enough absorption and follow-through to become actionable chart context?
📌 Overview / What it does
Order Flow Imbalance Recovery Planner maps high-volume displacement candles, converts them into practical imbalance recovery pockets, and evaluates whether price can recover that pocket with measurable response.
The script produces imbalance pockets, recovery rails, continuation corridors, invalidation shelves, target reference rails, event labels, and a compact AG Pro dashboard with a 0-100 recovery score.
This script does not read live order book data, footprint data, bid/ask tape, or true exchange-level order flow. It uses chart-available volume, relative volume, candle displacement, wick response, and recovery behavior as a practical visual proxy.
🎯 Purpose & Design Philosophy
The script was built for traders who want a structured way to study volume imbalance recovery instead of reacting to every large candle.
Many displacement candles look important at first, but the useful question is whether price can return to the pocket, absorb pressure, and recover the key rail.
The design supports a context-first workflow: identify the imbalance, observe the test, evaluate the recovery quality, and then read the current state.
⚡ Why This Script Is Different
Most tools mark volume spikes or wide candles as isolated events.
This script does NOT treat every high-volume candle as a signal.
Instead, it builds a recovery pocket, scores the reaction around that pocket, separates test conditions from READY conditions, and keeps invalidation visible.
⚙️ Methodology
1. Context Detection
The script searches for directional displacement candles with elevated relative volume, meaningful candle range, and sufficient body commitment.
2. Reference Mapping
When a valid imbalance is found, the script maps a recovery pocket and a recovery rail around the displacement body.
3. Reaction Evaluation
Price interaction with the pocket is evaluated through retest behavior, close location, wick response, relative volume, freshness, and failure distance.
4. Visual Output
The script displays the active pocket, recovery rail, target rails, invalidation shelf, event labels, bar state color, and dashboard state.
🗺️ How to Read the Chart
Zones represent the active imbalance recovery pocket.
The recovery rail marks the key level price needs to reclaim or lose before the context improves.
Labels highlight new imbalance pockets, pocket tests, ready recovery events, invalidations, and expirations.
Colors:
• Teal = bullish recovery context
• Pink = bearish recovery context or failed context
• Gold = neutral or wait state
• Indigo = monitor or reference state
The panel summarizes imbalance state, recovery score, flow response, risk, and action.
🚦 Signals & States
• Bull Imbalance → a bullish high-volume displacement pocket has been mapped
• Bear Imbalance → a bearish high-volume displacement pocket has been mapped
• Pocket Test → price is interacting with the active imbalance pocket
• Ready Recovery → the recovery score has reached the required threshold
• Invalidated → price has moved beyond the active failure edge
• Expired → the imbalance pocket is too old to remain active
🔔 Alerts Logic
Alerts can trigger when a new imbalance pocket is locked, when price tests the active pocket, when recovery reaches READY status, or when the context is invalidated.
Alerts are attention markers only. They are not trade instructions and do not guarantee future price behavior.
🧩 Confluence Logic
The context becomes stronger when high relative volume, large displacement, clean pocket retest, wick absorption, and recovery close align around the same pocket.
📊 When to Use
• After high-volume displacement candles
• During pullback and recovery phases
• Around breakout continuation attempts
• When studying absorption after aggressive movement
• On liquid symbols with reliable volume data
⚠️ When NOT to Use
• Very low-liquidity markets
• Symbols with unreliable volume data
• Extremely noisy sideways sessions
• News-driven spikes with unstable spreads
• Markets where chart volume does not represent meaningful participation
🎛️ Key Inputs
• Minimum Displacement Range → controls how large a candle must be relative to ATR
• Minimum Body Ratio → filters weak candles with too much wick noise
• Minimum Relative Volume → controls how much volume confirmation is required
• Minimum Ready Score → controls how strict the READY state is
• Projection Bars → controls how far active pockets and rails extend
• Visual Settings → control labels, zones, right-side tags, panel, font size, and bar colors
🖥️ Interface & Visual Design
The dashboard is designed as a quick decision-support panel, not a separate oscillator.
The chart uses a clear hierarchy: pocket first, recovery rail second, labels third, and targets only after recovery context becomes relevant.
The goal is to keep the chart premium, readable, and useful at first glance.
🧪 Practical Usage Workflow
1. Read the panel state
2. Locate the active imbalance pocket
3. Check whether price is testing or recovering the pocket
4. Review the recovery score and risk
5. Compare the output with broader market structure
🔍 Interpretation Guidelines
A READY state means the script has detected enough recovery behavior around the imbalance pocket to mark the context as worth attention.
It does not mean price must continue.
Use the output as structured context together with trend, liquidity, volatility, and higher-timeframe conditions.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a true order book, footprint, or bid/ask delta tool.
It is not an automated trading system.
It does not provide guaranteed signals.
It is not financial advice.
⚠️ Limitations & Transparency
The script uses chart-available data only.
Volume quality differs between markets, brokers, exchanges, and asset classes.
Timeframe changes may alter the appearance and timing of imbalance pockets.
Extreme volatility may produce rapid invalidation or repeated displacement events.
🧠 Market Context Notes
Order-flow style interpretation should always consider liquidity, volatility, structure, and session context.
A strong recovery pocket in a clean trend may carry more practical meaning than the same pocket inside a noisy range.
🧾 Use Case Examples
When price creates a high-volume bullish displacement candle and later retests the pocket, the script evaluates whether the retest shows enough absorption and recovery strength to become a READY context.
When price loses the recovery edge, the script marks invalidation rather than keeping the setup visually alive.
🧱 System Philosophy
AGPro Series tools are designed as decision-support engines.
The goal is not to simplify markets into blind signals, but to organize complex price behavior into readable structure, state, and risk context.
🔐 Non-Promise Statement
No script can provide certainty.
No signal guarantees continuation, reversal, or profit.
Outputs should be interpreted as analytical context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this tool to study how volume displacement, imbalance pockets, absorption, and recovery behavior interact across different markets and timeframes.
Indicator
Volume Trap Reversal Planner [AGPro Series]Volume Trap Reversal Planner
🧠 Core Idea
Did a volume spike trap one side of the market and reverse with enough confirmation to deserve attention?
📌 Overview / What it does
Volume Trap Reversal Planner is a chart-first reversal planning tool built around high-volume trap behavior.
Instead of treating every volume spike or wick sweep as a reversal signal, the script checks whether price expands through a recent reference, prints unusual relative volume, fails to hold the move, recovers back through the reference, and then confirms with a follow-through candle.
The output includes volume trap pockets, reclaim rails, risk edges, target-room bands, compact event labels, alerts, and a clean AGPro decision panel. It does not predict price, automate trades, or claim that every trap will reverse.
🎯 Purpose & Design Philosophy
The script was built for traders who want to separate meaningful high-volume trap events from ordinary noisy spikes.
Many reversal tools focus only on a wick, a candle pattern, or a support/resistance touch. This planner focuses on the decision layer after a volume trap forms: whether the trap is confirmed, where the risk edge sits, where target-room review begins, and what the next action state should be.
The design supports a structured review mindset: identify the trap, wait for confirmation, monitor the risk edge, and read the context through a 0-100 score instead of reacting to a single candle.
⚡ Why This Script Is Different
Most tools focus on volume spikes as standalone events or classify every sweep as a reversal attempt.
This script does NOT operate as a generic stop-run scanner, a broad liquidity sweep map, or a simple volume climax labeler.
Instead, it combines relative volume, wick sweep behavior, close recovery, confirmation candle quality, follow-through, risk edge placement, and target-room context into one planner-style reversal model.
⚙️ Methodology
1. Context Detection
The script builds a rolling high/low reference range and watches for unusual volume expansion near those references.
2. Trap Mapping
When price sweeps beyond the reference with elevated volume and recovers back inside, the script maps the volume trap pocket.
3. Reversal Evaluation
The planner evaluates wick quality, recovery strength, confirmation candle structure, follow-through distance, and the active risk edge.
4. Visual Output
The result is translated into a 0-100 reversal score, a next-action state, on-chart labels, risk/target guides, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = volume trap pockets created by a high-volume sweep and recovery.
Labels = trap watch, reversal ready, trap failed, or target review states.
Colors = bull-side reversals use teal, bear-side reversals use pink, watch states use amber, and review/target context uses indigo.
Panel = current trap side, volume spike multiple, reversal score, risk edge, and next action.
🚦 Signals & States
• VOL TRAP WATCH → a high-volume trap candidate formed and needs confirmation.
• REVERSAL READY → the trap received confirmation and reached the required score.
• TRAP FAILED → price closed beyond the risk edge and the active trap context weakened.
• TARGET REVIEW → price reached the target-room review band for the active plan.
🔔 Alerts Logic
Alerts trigger when a volume trap watch appears, when reversal confirmation reaches the required score, when the active trap fails through the risk edge, or when price reaches the target-room review band.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when volume spike quality, wick sweep behavior, close recovery, confirmation candle structure, and follow-through align in the same direction.
The score is intentionally multi-factor so a single dramatic candle does not dominate the interpretation.
📊 When to Use
• 4H charts for the cleanest public visual balance
• Markets with reliable volume data
• High-volume reactions around recent highs or lows
• Reversal review after failed breakout or failed breakdown attempts
• Active intraday or swing charts where trap behavior is visible
⚠️ When NOT to Use
• Very low-liquidity symbols
• Markets with unreliable or missing volume data
• Extremely noisy ranges where every candle sweeps both sides
• News-driven volatility where candle structure can distort normal context
🎛️ Key Inputs
• Trap Reference Lookback → controls the rolling high/low range used for trap detection.
• Volume Spike RVOL → adjusts how much relative volume is required.
• Sensitivity → changes sweep, wick, and volume selectivity.
• Confirmation Mode → controls how strict the confirmation candle must be.
• Risk / Target Logic → controls risk edge buffers and target-room bands.
• Visual Settings → control zones, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean AGPro panel and chart-first visual hierarchy.
Trap pockets show where the volume trap occurred. Labels identify the current state without overcrowding the chart. Risk and target guides make the output easier to interpret as a planning tool rather than a raw signal board.
🧪 Practical Usage Workflow
1. Read the panel and check the active trap side.
2. Inspect the volume trap pocket and reclaim rail.
3. Wait for reversal confirmation instead of reacting to the spike alone.
4. Compare the current state with the risk edge and target-room band.
5. Interpret the score within broader market context.
🔍 Interpretation Guidelines
A high score means the trap structure, volume spike, recovery, and confirmation are aligned more cleanly.
A watch state means the event is still developing.
A failed state means the active trap context has weakened or invalidated according to the script's rules.
Use the output as structured context, not as a standalone decision.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed reversal signal
• Not a generic liquidity sweep scanner
⚠️ Limitations & Transparency
Volume quality varies by symbol, exchange, and asset class.
Different timeframes may produce different trap pockets and confirmation states.
High volatility can make traps appear and fail quickly.
The script is rule-based and cannot know news, order flow intent, execution quality, or broader discretionary context.
🧠 Market Context Notes
Volume traps often matter most when they occur at obvious participation points, such as recent highs, recent lows, failed breakouts, or failed breakdowns.
The strongest use case is not the spike itself. The strongest use case is the sequence after the spike: recovery, confirmation, risk edge, and follow-through.
🧾 Use Case Examples
When price sweeps below a recent low on elevated volume, closes back above the reference, and confirms upward within the allowed window, the planner can mark a bullish reversal context.
When price sweeps above a recent high on elevated volume, fails to hold, and confirms downward, the planner can mark a bearish reversal context.
🧱 System Philosophy
Volume Trap Reversal Planner belongs to the AGPro planner-style workflow: detect the event, score the evidence, define the risk edge, map the review zone, and guide the next chart-reading step.
🔐 Non-Promise Statement
No trap, score, label, or alert can guarantee a reversal.
No script can provide certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and market interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the script to study how high-volume failed moves behave after sweeping recent references. The most useful insights come from comparing confirmed traps, failed traps, and ignored spikes across different markets and timeframes.
Indicator
Volume Rejection Planner [AGPro Series]Volume Rejection Planner
🧠 Core Idea
Did unusual volume appear at rejection in a way that changes the current decision context?
📌 Overview / What it does
Volume Rejection Planner is a chart-first volume reaction tool built to evaluate wick-led rejection events that appear with elevated relative volume near a recent range edge.
The script maps a volume rejection zone, a risk edge, a follow-through trigger, a room guide, compact state labels, and a clean AGPro planning panel. It converts relative volume, wick quality, close location, range-edge context, follow-through progress, and time decay into a 0-100 rejection quality score.
It does not predict price, automate trades, or mark every volume spike as meaningful. Its purpose is to organize the decision window after volume appears at a rejection wick.
🎯 Purpose & Design Philosophy
This script was built for traders who want more context than a raw volume spike or a simple wick marker.
High volume at a wick can mean participation, absorption, rejection, or noise depending on where it appears and what follows next. The planner focuses on that next question: is the rejection being accepted by follow-through, or is the event failing at its risk edge?
The design supports a decision-engine mindset: identify the rejection, measure its quality, locate invalidation, monitor follow-through, and decide whether the context deserves review, patience, or dismissal.
⚡ Why This Script Is Different
Most tools focus on volume spikes, climax candles, or generic wick rejection labels.
This script does NOT clone a Volume Climax Detector, does not become a Rejection Block tool, and does not draw generic support/resistance zones.
Instead, it treats high-volume wick rejection as a short lifecycle: event, test, accepted follow-through, failed risk edge, expired window, or room-guide reach. The main output is not a raw signal; it is a structured planning state.
⚙️ Methodology
1. Context Detection
The script builds a recent range-edge reference and checks whether the rejection wick occurs near the upper or lower edge.
2. Reference Mapping
When a qualified event appears, it maps the rejection zone, risk edge, follow-through trigger, and room guide.
3. Reaction Evaluation
The model scores relative volume, wick ratio, wick size, close location, edge quality, room, follow-through progress, pressure against the event, and time decay.
4. Visual Output
The result is shown through centered zone text, compact event labels, risk/room guides, candle tint, alerts, and a premium AGPro decision panel.
🗺️ How to Read the Chart
Volume Rejection Zone = the wick-led rejection area created by elevated participation at a range edge.
Risk Edge = the invalidation boundary beyond the rejection wick.
Follow-Through Trigger = the distance price must move away from the rejection to show accepted context.
Room Guide = a forward planning reference used to judge whether the reaction has enough space to matter.
Labels = compact BULL VRP / BEAR VRP markers for primary volume rejection events. Optional secondary labels can show monitor, accepted follow-through, expiry, and room-guide reach when the user wants a more detailed chart.
Colors = teal highlights bullish rejection context, pink highlights bearish rejection context, amber highlights watch context, indigo highlights room/guide context, and red highlights invalidation.
Panel = summarizes Rejection Volume, Wick Quality, Follow-Through, Risk Edge, and Action.
The panel focuses on fresh active context only. Older historical zones can remain on the chart without forcing the panel to display stale invalidated events.
🚦 Signals & States
• Volume Rejection Event → elevated relative volume appears with a qualifying wick near a range edge.
• Testing → the event exists, but accepted follow-through is not confirmed yet.
• Monitor → the active score is high enough to keep the context under review.
• Accepted → price has moved away from the rejection wick enough to confirm follow-through context.
• Risk Edge Broken → the event has moved through its invalidation boundary.
• Window Expired → the event did not confirm within the selected follow-through window.
• Room Guide Reached → the accepted context reached its planning guide.
🔔 Alerts Logic
Alerts trigger when a qualified volume rejection event appears, when the active context reaches READY, when the state changes, when the risk edge is broken, or when the room guide is reached.
Alerts are attention markers only. They are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest context appears when high relative volume, a clear wick ratio, a strong close back away from the wick, range-edge location, enough room, and quick follow-through align.
If price fails to move away from the rejection wick, presses back into the risk edge, or loses too much time, the planner downgrades the context.
📊 When to Use
• Range-edge reactions
• Wick rejection events with unusually high participation
• Failed pushes into recent highs or lows
• Markets where volume data is readable
• Situations where the next decision depends on whether rejection follows through
⚠️ When NOT to Use
• Very low-liquidity symbols with unreliable volume
• Extremely noisy micro-timeframes
• News spikes where wick behavior may distort quickly
• Markets where volume reporting is fragmented or unavailable
• Situations where the user expects a direct buy/sell signal
🎛️ Key Inputs
• Sensitivity → controls how strict the volume, wick, and edge requirements are.
• Range Edge Lookback → defines the recent high/low context used for rejection location.
• Minimum Rejection Score → controls which events are important enough to draw.
• Confirmation Mode → adjusts how quickly follow-through can be accepted.
• Follow-Through Window → controls how long the event remains active.
• Risk Edge Buffer → adjusts the invalidation boundary beyond the wick.
• Room Guide ATR → controls the planning guide distance.
• Visual settings → control zones, rails, primary labels, secondary labels, failure labels, candle tint, label density, and text size.
• Limit Historical Drawing / Historical Drawing Bars → controls how far back the script creates visual objects, improving load speed on long histories while preserving the current planning view.
• Adaptive HTF Events → slightly relaxes event thresholds on daily and weekly charts so higher timeframes do not look empty while intraday behavior stays stricter.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The rejection zone provides the visual anchor. The risk edge and room guide frame the planning context. Labels stay compact and offset away from candles so the chart remains active without becoming crowded.
The AGPro panel uses a merged blue title row and a compact five-row decision layout.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check whether the rejection zone is bullish or bearish.
3. Review the wick quality and relative volume.
4. Compare current price against the follow-through trigger and risk edge.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of event lifecycle, not prediction.
A stronger score means the rejection had better participation, wick structure, location, room, and follow-through behavior. A weaker or decaying score means the event is losing quality under the current rule set.
Accepted follow-through does not mean price must continue. It means the rejection event has met the script's conditions for stronger review context.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic volume spike marker
• Not a Rejection Block clone
• Not a Volume Climax Detector clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, wick structure, and volume behavior.
Different timeframes can change how rejection and follow-through appear. Volatility spikes can temporarily distort wick size and edge quality. Symbols with weak or unreliable volume may produce less useful readings.
Outputs should always be interpreted within broader structure, liquidity, volatility, and risk context.
🧠 Market Context Notes
Volume rejection is most useful when the wick appears at a meaningful location and the follow-up reaction is clear.
High volume alone is not enough. Location, close behavior, risk edge, and follow-through all matter.
🧾 Use Case Examples
When price pushes above a recent range edge, prints a strong upper wick with elevated RVOL, and then moves away from that wick, the planner may classify the context as accepted bearish rejection.
When price probes below a recent range edge, prints a strong lower wick with elevated RVOL, but then closes below the risk edge, the planner may classify the event as invalidated.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that approach by turning high-volume wick rejection into a structured decision question: is the event valid, strong, risky, accepted, or fading?
🔐 Non-Promise Statement
No indicator can provide certainty.
This tool provides structured visual context and rule-based attention markers. It does not guarantee continuation, reversal, rejection, or follow-through.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how volume behaves at wick rejection points, how quickly follow-through appears after rejection, and how risk edges help separate valid context from failed reaction events.
Indicator
Volume Follow-Through Planner [AGPro Series]Volume Follow-Through Planner
🧠 Core Idea
Did high volume create real continuation, or was it only a one-bar event?
📌 Overview / What it does
Volume Follow-Through Planner is a decision-oriented volume analytics overlay built to evaluate what happens after a qualified high-volume candle appears.
Instead of only marking volume spikes, the script opens a follow-through review window, measures next-bar progress, spread quality, close location, trend-side alignment, risk-rail defense, target-room progress, and converts the result into a 0-100 follow-through score.
It produces volume event labels, a forward follow-through box, a centered box label, a risk rail, a target-room guide, continuation/failure state labels, optional target-review labels, alert conditions, and a compact AGPro planning panel. It does not predict future price, automate execution, or claim that a high-volume event must continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want volume to answer a practical planning question: did the event actually create usable continuation context?
Many volume tools stop at detection. They show that volume was high, but they do not explain whether later candles accepted, extended, failed, or faded after the event.
Volume Follow-Through Planner fills that gap by treating volume as the start of a review process, not the final answer. The goal is a cleaner decision layer: event quality, follow-through quality, risk edge, bias context, and next action.
⚡ Why This Script Is Different
Most volume tools focus on identifying spikes, climaxes, absorption, or simple participation changes.
This script does NOT try to clone Volume Climax Detector, Volume Absorption Zones, Breakout Volume Quality, or a generic breakout scanner.
Instead, it focuses on post-event behavior. The volume event must be strong enough to matter, but the main question is what happens next: continuation, weak follow-through, risk building, target review, or failure.
⚙️ Methodology
1. Context Detection
The script measures local relative volume against a rolling volume baseline, normalizes candle spread by ATR, checks body quality, close location, and trend-side alignment.
2. Reference Mapping
When a qualified event appears, the script anchors a follow-through box from the event close toward a target-room guide and places a risk rail beyond the event candle.
3. Reaction Evaluation
During the review window, the planner measures next-bar progress, favorable movement, adverse movement, follow-through closes, rail defense, and time efficiency.
4. Visual Output
The result is converted into a 0-100 follow-through score, chart labels, centered box text, guide lines, panel rows, and alert conditions.
🗺️ How to Read the Chart
Zones = the follow-through box projected from the event close toward the target-room guide.
Labels = volume event, follow-through ready, one-bar event, target review, or failed event states.
Colors = teal for constructive bullish context, pink for constructive bearish context, yellow for caution, and indigo for target/strong review states.
Panel = compact decision summary showing Volume Event, Follow-Through, Spread Quality, Bias, and Action.
Risk rail = the invalidation reference behind the event candle. A confirmed close beyond it marks the active event as failed.
🚦 Signals & States
• Volume Event → a qualified high-volume candle opened a follow-through review.
• FT WATCH → the event is active but still needs more progress.
• FT READY → follow-through quality reached the planner threshold.
• RISK BUILDING → adverse movement is rising while the event is still active.
• ONE-BAR EVENT → volume appeared, but follow-through did not develop enough inside the review window.
• FAILED → price closed beyond the risk rail.
• TARGET REVIEW → the event reached the target-room guide and should be reviewed in context.
🔔 Alerts Logic
Alerts trigger when a qualified volume event appears, when follow-through reaches the ready threshold, when the risk rail is broken, when the target-room guide is reached, and when an event becomes a one-bar event.
Alerts are attention markers. They are not trade instructions, entry rules, or automated execution logic.
🧩 Confluence Logic
The strongest context appears when relative volume, spread quality, close location, next-bar progress, follow-through closes, and trend-side bias align.
When the event has strong participation but weak progress, the planner reduces the follow-through score instead of treating volume alone as enough.
📊 When to Use
• After noticeable participation expansion
• During directional continuation attempts
• Around strong candle events that need confirmation from later bars
• On liquid instruments with reliable volume data
• When the main question is whether volume created continuation or only temporary attention
⚠️ When NOT to Use
• Very low-liquidity symbols
• Charts with unreliable or missing volume data
• Extremely noisy micro timeframes
• Markets where one candle can distort volume baselines
• Conditions where the user needs a full volume profile, absorption zone, or climax detector instead
🎛️ Key Inputs
• Sensitivity → controls how demanding the volume event gate is.
• Volume Lookback → defines the baseline used for relative volume.
• Minimum Planner Score → sets the FT READY threshold.
• Follow-Through Window → controls how many bars are used for early review.
• Risk Rail Buffer → adjusts the invalidation reference behind the event candle.
• Target Guide ATR → controls the projected target-room guide.
• Cooldown Bars → limits repeated events around the same move.
• Visual settings → control labels, optional target-review labels, boxes, guide lines, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The panel is designed as a compact planning cockpit rather than a data dump.
The first row uses the AGPro blue merged header style, while the rows below focus only on the decision fields needed for fast interpretation.
The chart visuals are intentionally moderate: enough labels to make the chart feel active, but controlled by cooldown, maximum visible objects, and spacing settings.
🧪 Practical Usage Workflow
1. Read the panel and check whether a volume event is active.
2. Inspect the follow-through box and risk rail.
3. Watch whether price progresses beyond the event close or fades back toward the rail.
4. Use the Follow-Through score and Action row as context for further review.
5. Confirm the broader market structure, volatility, and liquidity environment separately.
🔍 Interpretation Guidelines
Think of the first volume event as a question, not an answer.
Strong follow-through means the event received continuation support. Weak follow-through means volume did not yet translate into useful directional progress. A failed event means the risk rail was broken and the original event context should be rejected.
The score is a planning aid. It should be interpreted with market structure, higher-timeframe context, and risk controls.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a volume climax detector
• Not an absorption zone map
• Not a generic support/resistance tool
⚠️ Limitations & Transparency
Volume quality depends on the chart symbol and exchange feed.
Timeframe changes can materially alter event frequency, volume baselines, and follow-through behavior.
Extreme volatility can make the risk rail or target-room guide less stable.
The script is rule-based and cannot understand news, liquidation cascades, macro events, or hidden order flow.
🧠 Market Context Notes
High volume is most useful when later candles confirm that participation had directional effect.
If price cannot progress after the event, the volume may represent temporary effort, late participation, absorption-like behavior, or simple noise.
This script focuses on that after-event evaluation.
🧾 Use Case Examples
When a strong bullish volume event appears and later candles close above the event close, the follow-through score can improve toward FT READY.
When a bearish volume event appears but price immediately reclaims the event area and breaks the rail, the state can shift to FAILED.
When volume expands but price stays trapped near the event close, the state can become ONE-BAR EVENT.
🧱 System Philosophy
The AGPro planner style is built around decision quality.
A chart tool should not only show what happened. It should help the user evaluate validity, strength, risk, target room, and the next state to monitor.
🔐 Non-Promise Statement
No script can provide certainty.
No signal, state, score, label, or alert guarantees a future outcome.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, risk management, and decisions.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the planner to study how volume events behave after they appear. The most important information is often not the event itself, but whether later candles confirm, weaken, or invalidate it.
Indicator
Candle Expansion Readiness [AGPro Series]Candle Expansion Readiness
🧠 Core Idea
Is the current candle expansion meaningful enough to monitor, or is it only a noisy wide candle?
📌 Overview / What it does
Candle Expansion Readiness is a chart-first candle quality planner built to evaluate whether an active expansion candle has enough structure to deserve attention.
Instead of treating every wide candle as important, the script studies body efficiency, wick control, relative volume, ATR-normalized expansion, recent range behavior, and close location. These components are converted into a 0-100 Expansion Readiness Score with a clear state: READY, WATCH, FADE RISK, or WAIT.
The script produces expansion candle labels, a forward follow-through box, risk edge, target guide, failure/fade states, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion candle will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want a cleaner way to judge expansion candles before reacting to them.
The gap it fills is practical: many candle tools mark a candle after it appears, but they do not explain whether that candle is efficient, supported, close-positioned, and monitorable. Candle Expansion Readiness turns that moment into a structured planning question.
The design supports a decision-first workflow: read the candle quality, check whether follow-through is developing, identify the risk edge, and decide whether the context deserves more attention.
⚡ Why This Script Is Different
Most tools focus on large candles, volume spikes, engulfing patterns, institutional candle labels, or general breakout signals.
This script does NOT clone Institutional Candle Detector, does not classify candles into institutional taxonomies, does not build an absorption system, and does not act as a generic breakout-volume tool.
Instead, it evaluates the current expansion candle as a readiness event. The output is not a trade command. It is a planning state that helps users separate monitorable expansion from weak, noisy, or fading candle behavior.
⚙️ Methodology
1. Context Detection
The script reads the active candle side from candle direction and close behavior, or lets the user force bullish or bearish readiness mode.
2. Reference Mapping
It maps the expansion candle, risk edge, follow-through window, and target guide.
3. Reaction Evaluation
The model scores body efficiency, wick control, relative volume, ATR expansion, recent range expansion, and directional close location.
4. Visual Output
The result appears through compact labels, candle glow, a forward follow-through box, risk edge, target guide, deterministic alerts, and the AGPro planning panel.
🗺️ How to Read the Chart
Zones = the follow-through box shows the monitored area from the expansion risk edge toward the target guide. Its label is centered inside the box.
Labels = compact markers show READY, WATCH, DOWNGRADE, CONFIRMED, INVALID, or FADED context.
Colors = green highlights stronger bullish readiness or confirmation, pink highlights bearish or invalidated context, amber highlights caution, and indigo highlights watch behavior.
Panel = the panel summarizes Candle Efficiency, Volume Support, Expansion Score, Follow-Through, and Action.
🚦 Signals & States
• READY → candle expansion quality is strong enough to monitor.
• WATCH → candle quality is improving but confirmation is incomplete.
• FADE RISK → the candle expanded, but wick or close behavior is weak.
• CONFIRMED → follow-through reached the active target guide.
• INVALIDATED → price crossed the active risk edge.
• FADED → the follow-through window expired without confirmation.
• WAIT → no strong enough expansion context is active.
🔔 Alerts Logic
Alerts trigger when the planner enters READY state, downgrades from READY or WATCH, crosses the active risk edge, confirms at the target guide, or fades after the follow-through window.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The readiness state becomes stronger when body efficiency, close location, relative volume, ATR expansion, and wick control align on the same candle.
When those elements align and the follow-through box remains active without risk-edge violation, the candle context becomes cleaner. When the score is high but follow-through fails, the planner intentionally downgrades the context instead of ignoring the failure.
📊 When to Use
• Active intraday or swing charts where candle expansion matters.
• Breakout attempts where candle quality needs review.
• Continuation moves that require follow-through monitoring.
• Reversal attempts where the trader wants to know whether the impulse candle is efficient or noisy.
• Liquid symbols with reliable OHLC and volume data.
⚠️ When NOT to Use
• Very low-liquidity markets with unreliable candles.
• Extremely noisy sessions where wide candles fail repeatedly.
• Symbols with poor or missing volume data if volume support is central to your workflow.
• News-driven spikes where normal candle-quality rules may lose relevance.
• As a standalone entry system without broader market context.
🎛️ Key Inputs
• Sensitivity → controls how strict the readiness model is.
• Expansion Lookback → compares the current candle to recent range behavior.
• READY Threshold → minimum 0-100 score required for READY state.
• Confirmation Mode → controls whether close quality alone is enough or whether volume/edge confirmation is required.
• Follow-Through Bars → defines how long the script monitors the active expansion.
• Risk Edge Buffer ATR → moves the invalidation reference slightly beyond the candle edge.
• Visual settings → control boxes, risk edge, target guide, candle glow, labels, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The panel gives the current decision state without becoming a crowded dashboard. The follow-through box creates a clean visual planning area, while compact labels keep the chart active without burying price candles.
The first panel row follows the AGPro merged blue header standard and shows only the script name.
🧪 Practical Usage Workflow
1. Read the Expansion Score and Action row.
2. Check whether the candle is READY, WATCH, or FADE RISK.
3. If READY appears, inspect the follow-through box and risk edge.
4. Watch whether price confirms, fades, or invalidates.
5. Interpret the result within your broader structure, liquidity, and risk plan.
🔍 Interpretation Guidelines
Think of the script as a candle expansion planner, not a signal caller.
A READY candle deserves attention because its structure is cleaner than average. A WATCH candle needs more evidence. A FADE RISK candle warns that expansion exists, but the candle quality is not clean. INVALIDATED and FADED states are part of the workflow because failed expansion is useful information.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not an institutional candle detector.
• Not an order block, fair value gap, or support/resistance map.
⚠️ Limitations & Transparency
• Timeframe differences can change how expansion candles appear.
• Volatility spikes can temporarily distort candle-quality readings.
• Volume data may differ by exchange, broker, symbol, and feed.
• Follow-through is evaluated through a fixed monitoring window.
• Market conditions can shift after a READY candle appears.
🧠 Market Context Notes
Candle expansion is most useful when interpreted with liquidity, structure, volatility, and location.
The script focuses on the candle itself and the immediate follow-through plan. Traders should still consider broader trend context, nearby levels, session behavior, and event risk.
🧾 Use Case Examples
When a bullish candle closes near its high with strong body efficiency and relative volume, the script may mark READY and project a follow-through box above the risk edge.
When a wide candle has heavy wick behavior and poor close location, the script may flag FADE RISK instead of treating the candle as clean expansion.
When a READY candle fails back through its risk edge, the active plan becomes INVALIDATED.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is to convert market behavior into clean, rule-based context that helps traders think more clearly.
Candle Expansion Readiness follows that philosophy by turning a single expansion candle into a monitored planning state.
🔐 Non-Promise Statement
No script can provide certainty.
This tool organizes candle expansion context, but it does not guarantee continuation, reversal, profit, or any specific market outcome.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, position sizing, and risk management.
Nothing in this script or description is financial advice.
📚 Educational Note
Use the script to study how clean expansion candles behave across different symbols and timeframes. The value is in comparing candle quality, follow-through, and failure behavior over time.
Indicator
