OPEN-SOURCE SCRIPT
Atualizado AG Pro VWMA Dislocation Map [AGPro Series]
AG Pro VWMA Dislocation Map [AGPro Series]
OVERVIEW
AG Pro VWMA Dislocation Map is a state-based charting tool designed to measure how far price is trading from its volume-weighted mean, how persistent that displacement has become, and whether the move is still expanding or beginning to normalize.
This script is built around a simple but often underexplored idea: distance from a moving average is not equally meaningful in all situations. A small deviation can matter when it is persistent and building under directional participation, while a larger deviation can become less informative when the move is already mature and beginning to contract. Instead of treating every separation from the mean as identical, this script organizes that behavior into a structured framework.
The result is a visual map centered on VWMA behavior rather than a classic crossover model. The goal is not to guess tops or bottoms, and it is not to replace broader market structure analysis. The goal is to help the user read displacement quality, persistence, and normalization pressure around a volume-weighted equilibrium reference.
This makes the script useful in two very different but related contexts. In intraday use, it can help identify when a move is still building away from the mean versus when extension may already be mature. In swing use, it can help frame whether price is holding a healthy distance from its weighted mean or rotating back toward equilibrium.
WHAT MAKES IT DIFFERENT
This script is not presented as “another moving average” and it is not intended to function as a simple VWMA trend filter. Its design focus is the behavior around VWMA, not the line by itself.
The main distinction is the state model. Instead of reducing the chart to a binary above/below interpretation, the script tracks whether displacement is mild, active, persistent, extended, overextended, re-approaching, or rebalanced. That adds context to moves that may otherwise look similar at first glance but are materially different in maturity and behavior.
A second distinction is normalization. Raw distance in price units can be misleading across different symbols, different volatility conditions, and different phases of the same market. For that reason, the script evaluates displacement relative to a normalization unit rather than using absolute price distance alone. This is intended to make the map more comparable and more structurally meaningful.
A third distinction is presentation. The indicator is designed as a chart-reading framework, with a central weighted-mean structure, layered displacement bands, background state context, a last-bar state label, and a compact information panel. The output is meant to be descriptive and contextual rather than promotional or predictive.
METHODOLOGY
The script begins with a VWMA reference built from user-defined length and source settings. Around that reference, it measures normalized price displacement. The normalization can be based on ATR, standard deviation, or a hybrid approach, depending on the selected mode.
From there, the script derives several internal components:
1. Distance
This reflects how far price is trading from the VWMA after normalization. The purpose is to measure relative displacement rather than raw tick or point difference.
2. Persistence
This tracks how long the current directional displacement has remained active. A move that has stayed consistently above or below the weighted mean for multiple bars may carry a different interpretation than a one-bar separation.
3. Expansion
This evaluates whether the displacement is still building. Rising displacement can indicate that price is not merely away from the mean, but continuing to separate from it.
4. Normalization
This evaluates whether the displacement is beginning to contract toward the mean. It does not forecast reversal by itself. It is intended to show whether the existing separation is losing expansion pressure and moving into a more balanced phase.
5. Regime
The script also classifies contextual slope behavior into a simplified regime reading. This is not meant to be a full market regime engine. It is a compact contextual aid for distinguishing broader trend-like conditions from quieter or more balanced environments.
These components feed the state engine and the panel metrics. The result is not a claim of certainty, but a structured way to read where price is operating relative to a volume-weighted center.
STATE MODEL
The indicator organizes behavior into discrete chart states. These states are designed for interpretation, not for deterministic outcome prediction.
Balanced
Price is trading close to the VWMA and displacement is limited.
Early Dislocation
Price is beginning to separate from the weighted mean, but the move is still in an early stage.
Persistent Dislocation
Distance is no longer only emerging; it has remained active for a more sustained period.
Extended
The move has reached a stronger separation from the mean and may require more caution in interpretation.
Overextended
Displacement is extreme relative to the current normalization model. This does not mean price must reverse immediately. It indicates an elevated extension condition.
Re-approaching
Distance is beginning to contract and the move may be rotating back toward VWMA equilibrium.
Rebalanced
Price has moved back toward the mean after a prior displacement phase.
The practical value of this model is that it helps separate fresh movement from mature movement. Two charts can both be above VWMA, but one may be in an early building phase while another may already be extended and normalizing.
HOW TO READ THE PANEL
The information panel is designed to provide a quick summary of the current state without overwhelming the chart.
Score
A composite reading of displacement behavior. This is a contextual score, not a performance metric and not a probability estimate.
Bias
A directional summary based on price relative to VWMA.
Regime
A simplified context tag derived from the weighted-mean behavior.
Distance
The current normalized displacement from VWMA.
Persistence
The number of bars associated with the current directional displacement run.
Normalization
A compact measure of contraction pressure toward the weighted mean.
Footer interpretation
A short descriptive line showing the current qualitative state context and whether displacement is expanding or contracting.
The panel is intended to summarize current conditions, not to replace full chart reading.
VISUAL STRUCTURE
The chart output is designed to be read in layers.
The central weighted-mean structure provides the equilibrium reference.
The inner visual structure highlights the core region around VWMA.
The displacement bands expand outward to show increasingly stretched conditions relative to the normalization thresholds.
The background tint provides a broad state cue so users can quickly identify periods of balance, active displacement, or higher extension.
The last-bar state label is included to make the current state readable at a glance without scanning the full panel.
This layered design is intentional. It allows the script to remain visually expressive while still communicating a hierarchy: center, displacement, extension, and normalization.
HOW THIS TOOL MAY BE USED
Some users may apply the script as a continuation context tool. In that workflow, the focus is less on exact entries and more on whether a move is still developing in a healthy way away from the weighted mean.
Some users may apply it as an extension-awareness tool. In that workflow, the purpose is to identify when a move may already be mature and when aggressive continuation assumptions deserve more caution.
Others may use it as a mean-normalization context tool. In that workflow, the interest is not whether price is simply above or below VWMA, but whether the separation is holding, expanding, or rotating back toward equilibrium.
Because of this flexibility, the script is not restricted to one market style. It can be used as an analytical overlay in trending markets, in rotational conditions, or as part of a broader discretionary review process.
SIGNALS AND ALERTS
The script includes alerts tied to state transitions and context changes. These alerts are descriptive events based on the model, not trade promises.
Persistent Dislocation
Triggers when the script enters the Persistent Dislocation state.
Extended
Triggers when the script enters the Extended state.
Overextended
Triggers when the script enters the Overextended state.
Re-approaching
Triggers when the script enters the Re-approaching state.
Rebalanced
Triggers when price rotates back toward the weighted mean after prior displacement.
Score Threshold Cross
Triggers when the composite score crosses above the user-defined threshold.
Bias Flip
Triggers when directional bias flips across VWMA.
These alerts are intended to support monitoring and workflow organization. They should be interpreted in the context of the broader chart.
KEY INPUTS
VWMA Length
Controls the length of the volume-weighted mean.
Normalization Mode
Selects whether normalized displacement is built from ATR, standard deviation, or a hybrid of the two.
Normalization Length
Controls the lookback used in the normalization engine.
Distance Smoothing
Adjusts smoothing applied to the displacement behavior.
Regime Lookback
Controls the lookback used in the regime context calculation.
State Thresholds
Define how mild, active, strong, and extreme displacement are classified.
Persistence Confirmation Bars
Helps distinguish brief separation from more sustained displacement.
Re-Approach Confirmation Bars
Controls how quickly the script recognizes contraction back toward the mean.
Visual Settings
Allow the user to manage bands, background context, VWMA visibility, line strength, opacity behavior, and label placement.
Panel Settings
Allow layout, position, theme, and text sizing adjustments.
The script is intended to be configurable so the same framework can be adapted to different symbols and timeframes without changing its core logic.
LIMITATIONS AND TRANSPARENCY
This script does not predict future price direction.
It is not a standalone trading system, not an execution engine, and not a substitute for full chart analysis.
A strong displacement can remain strong for longer than expected. An overextended reading does not guarantee immediate reversal. A re-approaching or rebalanced state does not guarantee that a larger directional move has ended.
Like any normalized framework, the output depends on the settings chosen by the user. Different symbols, timeframes, volatility environments, and threshold selections can meaningfully change the visual behavior and state classification.
The script should be understood as a descriptive map around a volume-weighted mean, not as a promise of edge by itself.
RISK DISCLOSURE
This indicator is for analytical and educational charting use only.
It does not provide financial advice, investment advice, or guaranteed outcomes.
All trading and investing involve risk. Users should evaluate any signal, state change, or alert in the context of their own process, market conditions, risk controls, and independent judgment.
AG Pro VWMA Dislocation Map is designed to help structure interpretation around VWMA displacement behavior. It is not designed to remove uncertainty from markets, and it should not be used as the sole basis for financial decisions.
OVERVIEW
AG Pro VWMA Dislocation Map is a state-based charting tool designed to measure how far price is trading from its volume-weighted mean, how persistent that displacement has become, and whether the move is still expanding or beginning to normalize.
This script is built around a simple but often underexplored idea: distance from a moving average is not equally meaningful in all situations. A small deviation can matter when it is persistent and building under directional participation, while a larger deviation can become less informative when the move is already mature and beginning to contract. Instead of treating every separation from the mean as identical, this script organizes that behavior into a structured framework.
The result is a visual map centered on VWMA behavior rather than a classic crossover model. The goal is not to guess tops or bottoms, and it is not to replace broader market structure analysis. The goal is to help the user read displacement quality, persistence, and normalization pressure around a volume-weighted equilibrium reference.
This makes the script useful in two very different but related contexts. In intraday use, it can help identify when a move is still building away from the mean versus when extension may already be mature. In swing use, it can help frame whether price is holding a healthy distance from its weighted mean or rotating back toward equilibrium.
WHAT MAKES IT DIFFERENT
This script is not presented as “another moving average” and it is not intended to function as a simple VWMA trend filter. Its design focus is the behavior around VWMA, not the line by itself.
The main distinction is the state model. Instead of reducing the chart to a binary above/below interpretation, the script tracks whether displacement is mild, active, persistent, extended, overextended, re-approaching, or rebalanced. That adds context to moves that may otherwise look similar at first glance but are materially different in maturity and behavior.
A second distinction is normalization. Raw distance in price units can be misleading across different symbols, different volatility conditions, and different phases of the same market. For that reason, the script evaluates displacement relative to a normalization unit rather than using absolute price distance alone. This is intended to make the map more comparable and more structurally meaningful.
A third distinction is presentation. The indicator is designed as a chart-reading framework, with a central weighted-mean structure, layered displacement bands, background state context, a last-bar state label, and a compact information panel. The output is meant to be descriptive and contextual rather than promotional or predictive.
METHODOLOGY
The script begins with a VWMA reference built from user-defined length and source settings. Around that reference, it measures normalized price displacement. The normalization can be based on ATR, standard deviation, or a hybrid approach, depending on the selected mode.
From there, the script derives several internal components:
1. Distance
This reflects how far price is trading from the VWMA after normalization. The purpose is to measure relative displacement rather than raw tick or point difference.
2. Persistence
This tracks how long the current directional displacement has remained active. A move that has stayed consistently above or below the weighted mean for multiple bars may carry a different interpretation than a one-bar separation.
3. Expansion
This evaluates whether the displacement is still building. Rising displacement can indicate that price is not merely away from the mean, but continuing to separate from it.
4. Normalization
This evaluates whether the displacement is beginning to contract toward the mean. It does not forecast reversal by itself. It is intended to show whether the existing separation is losing expansion pressure and moving into a more balanced phase.
5. Regime
The script also classifies contextual slope behavior into a simplified regime reading. This is not meant to be a full market regime engine. It is a compact contextual aid for distinguishing broader trend-like conditions from quieter or more balanced environments.
These components feed the state engine and the panel metrics. The result is not a claim of certainty, but a structured way to read where price is operating relative to a volume-weighted center.
STATE MODEL
The indicator organizes behavior into discrete chart states. These states are designed for interpretation, not for deterministic outcome prediction.
Balanced
Price is trading close to the VWMA and displacement is limited.
Early Dislocation
Price is beginning to separate from the weighted mean, but the move is still in an early stage.
Persistent Dislocation
Distance is no longer only emerging; it has remained active for a more sustained period.
Extended
The move has reached a stronger separation from the mean and may require more caution in interpretation.
Overextended
Displacement is extreme relative to the current normalization model. This does not mean price must reverse immediately. It indicates an elevated extension condition.
Re-approaching
Distance is beginning to contract and the move may be rotating back toward VWMA equilibrium.
Rebalanced
Price has moved back toward the mean after a prior displacement phase.
The practical value of this model is that it helps separate fresh movement from mature movement. Two charts can both be above VWMA, but one may be in an early building phase while another may already be extended and normalizing.
HOW TO READ THE PANEL
The information panel is designed to provide a quick summary of the current state without overwhelming the chart.
Score
A composite reading of displacement behavior. This is a contextual score, not a performance metric and not a probability estimate.
Bias
A directional summary based on price relative to VWMA.
Regime
A simplified context tag derived from the weighted-mean behavior.
Distance
The current normalized displacement from VWMA.
Persistence
The number of bars associated with the current directional displacement run.
Normalization
A compact measure of contraction pressure toward the weighted mean.
Footer interpretation
A short descriptive line showing the current qualitative state context and whether displacement is expanding or contracting.
The panel is intended to summarize current conditions, not to replace full chart reading.
VISUAL STRUCTURE
The chart output is designed to be read in layers.
The central weighted-mean structure provides the equilibrium reference.
The inner visual structure highlights the core region around VWMA.
The displacement bands expand outward to show increasingly stretched conditions relative to the normalization thresholds.
The background tint provides a broad state cue so users can quickly identify periods of balance, active displacement, or higher extension.
The last-bar state label is included to make the current state readable at a glance without scanning the full panel.
This layered design is intentional. It allows the script to remain visually expressive while still communicating a hierarchy: center, displacement, extension, and normalization.
HOW THIS TOOL MAY BE USED
Some users may apply the script as a continuation context tool. In that workflow, the focus is less on exact entries and more on whether a move is still developing in a healthy way away from the weighted mean.
Some users may apply it as an extension-awareness tool. In that workflow, the purpose is to identify when a move may already be mature and when aggressive continuation assumptions deserve more caution.
Others may use it as a mean-normalization context tool. In that workflow, the interest is not whether price is simply above or below VWMA, but whether the separation is holding, expanding, or rotating back toward equilibrium.
Because of this flexibility, the script is not restricted to one market style. It can be used as an analytical overlay in trending markets, in rotational conditions, or as part of a broader discretionary review process.
SIGNALS AND ALERTS
The script includes alerts tied to state transitions and context changes. These alerts are descriptive events based on the model, not trade promises.
Persistent Dislocation
Triggers when the script enters the Persistent Dislocation state.
Extended
Triggers when the script enters the Extended state.
Overextended
Triggers when the script enters the Overextended state.
Re-approaching
Triggers when the script enters the Re-approaching state.
Rebalanced
Triggers when price rotates back toward the weighted mean after prior displacement.
Score Threshold Cross
Triggers when the composite score crosses above the user-defined threshold.
Bias Flip
Triggers when directional bias flips across VWMA.
These alerts are intended to support monitoring and workflow organization. They should be interpreted in the context of the broader chart.
KEY INPUTS
VWMA Length
Controls the length of the volume-weighted mean.
Normalization Mode
Selects whether normalized displacement is built from ATR, standard deviation, or a hybrid of the two.
Normalization Length
Controls the lookback used in the normalization engine.
Distance Smoothing
Adjusts smoothing applied to the displacement behavior.
Regime Lookback
Controls the lookback used in the regime context calculation.
State Thresholds
Define how mild, active, strong, and extreme displacement are classified.
Persistence Confirmation Bars
Helps distinguish brief separation from more sustained displacement.
Re-Approach Confirmation Bars
Controls how quickly the script recognizes contraction back toward the mean.
Visual Settings
Allow the user to manage bands, background context, VWMA visibility, line strength, opacity behavior, and label placement.
Panel Settings
Allow layout, position, theme, and text sizing adjustments.
The script is intended to be configurable so the same framework can be adapted to different symbols and timeframes without changing its core logic.
LIMITATIONS AND TRANSPARENCY
This script does not predict future price direction.
It is not a standalone trading system, not an execution engine, and not a substitute for full chart analysis.
A strong displacement can remain strong for longer than expected. An overextended reading does not guarantee immediate reversal. A re-approaching or rebalanced state does not guarantee that a larger directional move has ended.
Like any normalized framework, the output depends on the settings chosen by the user. Different symbols, timeframes, volatility environments, and threshold selections can meaningfully change the visual behavior and state classification.
The script should be understood as a descriptive map around a volume-weighted mean, not as a promise of edge by itself.
RISK DISCLOSURE
This indicator is for analytical and educational charting use only.
It does not provide financial advice, investment advice, or guaranteed outcomes.
All trading and investing involve risk. Users should evaluate any signal, state change, or alert in the context of their own process, market conditions, risk controls, and independent judgment.
AG Pro VWMA Dislocation Map is designed to help structure interpretation around VWMA displacement behavior. It is not designed to remove uncertainty from markets, and it should not be used as the sole basis for financial decisions.
Notas de Lançamento
UPDATE NOTES - V1.6This update focuses on presentation quality, visual hierarchy, and chart readability.
The underlying framework of the script remains centered on VWMA-based dislocation mapping, including normalized distance measurement, persistence tracking, regime context, re-approach logic, and the existing alert architecture. The purpose of this release is not to redefine the tool, but to make the same framework easier to read, easier to follow, and more visually coherent in live chart use.
What changed in V1.6
1) Refined VWMA visual anchor
The VWMA is now presented with a stronger visual hierarchy so that the center of gravity is easier to identify at a glance. A dedicated accent layer was added around the main VWMA line, while the core line itself remains clean and readable. This improves the sense of structure without turning the chart into a line-heavy display.
2) Reworked dislocation zone layering
The band system was visually reorganized to better separate the equilibrium area from developing and extended displacement phases. In addition to the existing core, dislocation, and extension structure, the transition from the core zone into the first dislocation band now reads more clearly on the chart. The goal here is better depth perception and better recognition of when price is simply near VWMA equilibrium versus when it is beginning to stretch away from that equilibrium.
3) Lighter and cleaner zone presentation
Zone fills were rebalanced so that candles and nearby structure remain readable. This was an important polish step because the script is designed to sit directly on price. The updated default presentation keeps the bands visible and informative, while reducing the sense that the chart is being overly covered by fills.
4) Cleaner state background behavior
The state background was adjusted so that it supports context instead of dominating the chart. Balanced conditions no longer compete visually with more meaningful phases, and the remaining background shading now acts more as a contextual cue than as a foreground element. This helps the bands and price bars remain the primary focus.
5) Premium last-bar state label refresh
The right-side state label was redesigned to look cleaner and more compact. It now communicates the active state, score, and directional bias in a more efficient format. The label also uses a more refined color treatment so that it feels integrated with the overall chart design rather than appearing as a generic status tag.
6) Panel readability and terminology cleanup
The summary panel received a full presentation pass. Contrast, row separation, and header treatment were improved so that the panel is easier to read in practical use. In addition, the re-approach metric is now labeled more clearly inside the panel, which makes the normalization process easier to interpret without changing how that metric is calculated.
7) Optional visual event markers
A lightweight visual marker layer was introduced for a small number of key state transitions. These markers are intentionally selective rather than dense. Their purpose is to help the user visually recognize important overextension or rebalance moments without turning the script into an annotation-heavy overlay.
8) New visual controls
Additional visual toggles were added so users can better tailor the script to their chart style. This includes dedicated control over the VWMA accent layer and the key state markers. These settings make it easier to keep the tool either more expressive or more minimal, depending on preference.
What did not change
- The script is still a VWMA dislocation mapping tool, not a prediction engine.
- The state framework still revolves around distance, persistence, extension, re-approach, and rebalance behavior around VWMA.
- The main alert set remains focused on state entry, rebalance, optional score threshold crossing, and optional bias flips.
- This update does not change the general purpose of the script. It improves visual interpretation and chart usability.
Why this update matters
VWMA-based tools can lose effectiveness if the chart becomes visually flat, overly soft, or too cluttered to interpret quickly. This release addresses that problem directly. The script now reads more clearly in trend continuation, post-expansion digestion, and equilibrium reversion phases, while maintaining a cleaner relationship with raw price action.
In practical terms, V1.6 should make it easier to distinguish three things quickly:
- when price is still operating near volume-weighted equilibrium,
- when dislocation is beginning to build and persist,
- and when an extended move is starting to mature or rebalance.
Limitations and transparency
This script is a structured chart-reading tool. It does not forecast future price direction and it should not be interpreted as a standalone trading system. VWMA dislocation can remain active longer than expected in strong trends, and equilibrium behavior can vary across symbols, volatility regimes, and timeframes. Threshold and normalization settings may require adjustment depending on the asset being analyzed.
Risk disclosure
This indicator is provided for educational and analytical purposes only. It is designed to support chart interpretation, not to provide financial advice or guaranteed outcomes. All trading and investment decisions remain the responsibility of the user.
Notas de Lançamento
AG Pro VWMA Dislocation Map [AGPro Series]Update Notes - V1.8
This update focuses on presentation quality, readability, and cleaner state visibility while preserving the script’s core VWMA dislocation framework.
What was improved:
- Refined the visual structure of the dislocation bands for a cleaner chart appearance.
- Reduced band fill intensity so candles remain easier to read during active conditions.
- Softened the overall zone presentation to improve chart balance without removing context.
- Improved the panel layout to better match the current AG Pro visual standard.
- Kept the top panel row as a single merged title row with the standardized blue header style.
- Preserved a compact default panel footprint for better chart space efficiency.
- Maintained a small default panel font size and a normal default label size for clarity.
- Improved state presentation so the chart remains visually informative without feeling overloaded.
- Kept the script’s VWMA-centered dislocation logic intact while refining the way conditions are displayed.
- Applied general UI cleanup to create a more polished and premium overall look.
Notes:
- This update is primarily visual and structural.
- The script remains an analytical tool for mapping price displacement around VWMA.
- It does not predict future price direction and should be used as part of a broader chart-reading process.
Notas de Lançamento
Update Notes - V2.0This update keeps the original VWMA dislocation concept intact, but gives it a much stronger visual identity and a clearer publication-ready workflow.
- Kept the published script title `AG Pro VWMA Dislocation Map [AGPro Series]` unchanged to preserve continuity with the existing release.
- Rebuilt the panel to match the current AGPro visual standard, including a single merged blue header row, adjustable location, adjustable theme, and default Normal font sizing.
- Added premium event labels with controlled spacing so the chart feels alive without becoming noisy or overcrowded.
- Added stretch memory zones that project mature and exhausted dislocation areas forward as rectangular context zones.
- Refined the state model language into a more polished sequence: Build-Up, Active Stretch, Mature Stretch, Exhaustion, Mean Repair, and Rebalanced.
- Upgraded the VWMA visual stack with a cleaner accent layer, more deliberate band hierarchy, and stronger screenshot quality for publish view.
- Added professional English tooltips across the settings so the script feels more complete for public free release.
- Preserved lightweight performance by keeping the logic overlay-focused, capped, and free of unnecessary drawing churn.
Positioning
The updated version keeps the original VWMA dislocation identity, but now presents it with a stronger stretch-and-repair framework, clearer state progression, forward memory zones, and stronger publication aesthetics.
Notas de Lançamento
🔧 UPDATE NOTES - V2.1This update focuses on readability, structure, visual clarity, and publication-grade usability.
The core purpose of the script remains unchanged.
This release improves how VWMA distance, dislocation persistence, exhaustion risk, and mean repair context are presented on the chart.
This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
• Updated the public script title format.
The script name now follows the current AGPro Series naming standard: VWMA Dislocation Map [AGPro Series].
• Rebuilt the visual structure around an active VWMA dislocation pocket.
Confirmed stretch phases now create a cleaner projected pocket with centered text and a midpoint guide.
• Added a clearer decision-style panel.
The panel now emphasizes Dislocation Score, State, Bias, Repair, and Action instead of only raw technical metrics.
• Added right-side context tags.
The chart now displays compact tags for stretch distance, VWMA, repair rail, and current action context.
• Improved event labeling.
State labels are more selective and easier to read, with density controls to reduce overlap and preserve a premium chart layout.
------------------------
Visual Improvements
------------------------
• Improved chart readability by adjusting VWMA bands, dislocation pockets, right-side tags, and event label spacing.
• Reduced visual clutter by using controlled event label memory and selective memory zones.
• Refined visual hierarchy so VWMA, stretch distance, mean repair context, and action state stand out more clearly.
• Adjusted positioning of elements to avoid overlap with candles and keep the chart cleaner for publishing screenshots.
------------------------
Interface & Usability
------------------------
• Optimized panel layout for clearer information flow.
• Added configurable panel visibility, panel location, panel theme, panel font size, and label font size.
• Kept label text size default at Normal for better chart readability.
• Enhanced overall user experience without changing the core concept into an automated signal system.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical purpose of the script.
The goal is to improve clarity and usability, not to introduce predictive behavior.
Users should interpret outputs as VWMA dislocation context:
distance from the volume-weighted mean, persistence, exhaustion risk, and possible mean repair pressure.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, timeframe differences, and unusual volume behavior may affect how dislocation states appear.
Outputs should always be interpreted within broader market context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
Notas de Lançamento
UPDATE NOTES - V2.3This update focuses on chart readability, visual hierarchy, and publication-grade default behavior.
The core purpose of the script remains unchanged.
This release improves how the existing VWMA dislocation logic is presented, organized, and interpreted on the chart.
This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- Refined default visual density.
The chart now keeps the VWMA dislocation story visible without overloading the screen with too many memory zones, side tags, or repeated labels.
- Reduced completed memory-zone retention.
The default memory-zone count was lowered so prior dislocation areas remain useful context instead of becoming the dominant visual layer.
- Added optional memory-zone badges.
Completed memory-zone text is now optional by default, giving users cleaner publication screenshots while preserving the ability to show additional context when desired.
- Disabled right-side tags by default.
The panel now carries the primary live summary, while right-side tags remain available as an optional overlay for users who prefer more chart-side detail.
- Refined active pocket behavior.
Active dislocation pockets are now visually capped around the relevant VWMA stretch side, making the current zone easier to read and less likely to cover unrelated candle structure.
- Simplified label language.
Event labels now use shorter, premium wording such as Extreme, Mature Stretch, Mean Repair, and Rebalanced.
------------------------
Visual Improvements
------------------------
- Softer VWMA band and fill transparency improves first-glance readability.
- Fewer default event labels reduce overlap while keeping a meaningful chart story.
- Centered pocket badges remain contrast-safe and use filled labels rather than floating light text.
- Memory zones are calmer and less visually dominant in default settings.
- Right-side context, when enabled, is reduced to the most useful repair and action references.
------------------------
Interface & Usability
------------------------
- The panel keeps a single merged AGPro blue header row.
- Panel visibility, location, theme, and font-size controls remain available.
- Label font-size control remains available and defaults to Normal.
- Default settings are tuned for a cleaner public-release chart without changing the underlying analytical model.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure and cleaner chart hierarchy.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, symbol behavior, and timeframe differences may affect how VWMA dislocation states appear.
Outputs should always be interpreted within broader market context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
Notas de Lançamento
UPDATE NOTES - v2.4This update focuses on label and panel readability.
The core purpose of the script remains unchanged. This release improves how the
existing dislocation labels, pocket badges, and panel read on the chart, with
text that stays clear on every state color and on both panel themes.
This script continues to function as an analytical and visualization tool. It
does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- More accurate contrast-aware text
The text-color selection used for labels, pocket badges, and colored panel
cells was upgraded to a brightness-accurate method, so amber, mint, pink, and
indigo elements all pick a clearly readable text color.
- Theme-aware panel values
The colored panel values now pick a readable color on both the Dark and Light
panel themes, so light state colors no longer fade on the light background.
- Stronger alternating panel rows
The alternating panel row background was adjusted on both themes for a cleaner,
more balanced look.
- Leaner code
Unused panel color helpers were removed.
------------------------
Visual Improvements
------------------------
- Contrast-safe dislocation labels and centered pocket badges across all states.
- Improved panel contrast across all rows on both themes.
- Adjusted alternating row shading for a more premium appearance.
- Preserved the familiar VWMA, dislocation bands, pocket, and memory zone layout.
------------------------
Interface & Usability
------------------------
- Cleaner, more readable dislocation labeling.
- Improved panel contrast across all rows on both themes.
- Adjusted default visual presentation for a more balanced, premium appearance.
- Enhanced overall user experience without changing core logic.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The VWMA anchor, the normalized distance engine, the persistence and repair
tracking, the build-up, active, mature, exhaustion, repair, and rebalanced state
classification, the dislocation and repair scores, and every panel statistic all
behave exactly as before.
Users should interpret outputs the same way as before, but with cleaner labels
and a more readable panel.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may
affect how dislocation states appear. Outputs should always be interpreted
within broader market context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes. Users
remain responsible for their own decisions.
Notas de Lançamento
🔧 UPDATE NOTES - v2.5This update adds a rebalance-rate proof to the dislocation map.
The core purpose of the script remains unchanged.
This release keeps the same VWMA distance model, states and pockets, and adds a historical
track record of how often dislocations repaired back toward the VWMA equilibrium.
This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- Rebalance Rate proof layer
The panel now reports how often a dislocation repaired back inside the build-up threshold
within a defined window, shown with the sample count for transparency.
- Rebalance Proof Window input
A new setting controls the window used to measure repair, so the rate reflects prompt mean
repair rather than the eventual repair that any mean model produces over time.
- Per-dislocation counting
Each dislocation pocket is counted once, so the rate is an honest measure of repair behavior
on the selected market and timeframe.
- Panel hierarchy
Added the Rebalance Rate row under Repair Context so the live repair motion and its historical
track record sit together.
------------------------
Visual Improvements
------------------------
- Kept the VWMA bands, pockets and event labels unchanged
- Preserved the contrast-safe centered pocket badge and memory zones
- Maintained the clean, candle-clear chart layout
- Left the publication-ready visual style intact
------------------------
Interface & Usability
------------------------
- Added a Rebalance Rate row for an at-a-glance repair track record
- Added a window setting so the proof measures prompt repair
- Kept the existing workflow, state, score, location and repair hierarchy
- Enhanced overall user experience without changing the core dislocation logic
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The VWMA distance, states and pockets are unchanged. The Rebalance Rate is a separate
historical track-record layer and does not alter how dislocation is detected.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how
dislocations, repair and the rate appear.
Outputs should always be interpreted within broader market context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
Script de código aberto
Em verdadeiro espírito do TradingView, o criador deste script o tornou de código aberto, para que os traders possam revisar e verificar sua funcionalidade. Parabéns ao autor! Embora você possa usá-lo gratuitamente, lembre-se de que a republicação do código está sujeita às nossas Regras da Casa.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Aviso legal
As informações e publicações não se destinam a ser, e não constituem, conselhos ou recomendações financeiras, de investimento, comerciais ou de outro tipo fornecidos ou endossados pela TradingView. Leia mais nos Termos de Uso.
Script de código aberto
Em verdadeiro espírito do TradingView, o criador deste script o tornou de código aberto, para que os traders possam revisar e verificar sua funcionalidade. Parabéns ao autor! Embora você possa usá-lo gratuitamente, lembre-se de que a republicação do código está sujeita às nossas Regras da Casa.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Aviso legal
As informações e publicações não se destinam a ser, e não constituem, conselhos ou recomendações financeiras, de investimento, comerciais ou de outro tipo fornecidos ou endossados pela TradingView. Leia mais nos Termos de Uso.