OPEN-SOURCE SCRIPT
Zaktualizowano

AG Pro Displacement Quality Finder [AGPro Series]

754
AG Pro Displacement Quality Finder [AGPro Series]

Overview / What It Does

AG Pro Displacement Quality Finder is designed to identify displacement candles that stand out for structural intent rather than simple size alone. Instead of highlighting every large bar on the chart, the script evaluates whether a candle shows the type of directional expansion that traders often associate with meaningful repricing. The goal is to help separate ordinary volatility from displacement events that may deserve closer attention.

The core logic focuses on the quality of the candle itself and the context immediately connected to it. A displacement candle can look impressive at first glance while still lacking the characteristics that make it useful in analysis. This script addresses that problem by combining body expansion measurements, marubozu-style pressure assessment, and optional volume confirmation into a single quality framework. The result is a more selective view of bullish and bearish displacement conditions.

Once a valid event is detected, the script does not stop at marking the candle. It also maps a follow-up reclaim zone derived from the displacement structure so the user can monitor whether price revisits, respects, or interacts with that area later. This creates a workflow that is not limited to signal spotting. It extends the idea into post-event tracking, which is often the more practical part of chart analysis.

The visual design is intended to keep the chart readable while still making the key information obvious. Displacement candles can be recolored, quality tags can classify stronger events, and reclaim zones can remain visible long enough to preserve market context. The panel summarizes the latest state and core ratios so the user can quickly understand why the most recent event qualified.

Unique Edge

The distinctive feature of this script is that it treats displacement as a quality problem, not just a range problem. Many tools mark large candles. This script tries to isolate higher-conviction expansion candles by checking whether the body is meaningfully large relative to ATR and average body size, whether the candle shows strong close-to-extreme behavior, and whether optional volume confirmation supports the move.

A second differentiator is the reclaim-zone workflow. Instead of placing a marker and ending the analysis there, the script projects a reclaim area from the detected displacement structure. That makes the tool useful both at the moment of expansion and in the bars that follow. Traders who study impulsive moves often care just as much about what happens after the expansion candle as they do about the candle itself.

The script also uses visual hierarchy to keep stronger and more relevant structures easier to read than older or lower-priority ones. This helps reduce the “everything matters equally” problem that often makes zone-based tools harder to use in practice.

Methodology

The script evaluates bullish and bearish displacement candidates using multiple filters that are designed to work together rather than as isolated checks. At the center of the model is body expansion. The candle body is compared against ATR and against an average-body baseline so that the script can judge whether a bar is unusually forceful for the instrument and timeframe being viewed.

A marubozu-proximity component is then used to assess directional cleanliness. In simple terms, the script looks for candles whose closing behavior suggests genuine directional pressure rather than a wide but indecisive bar. This helps reduce false positives from candles that are large in total range but weak in directional conviction.

An optional volume confirmation layer can be enabled for users who want displacement selection to include participation strength. This does not redefine the script into a volume indicator. It simply acts as an additional confirmation filter for users who prefer more selectivity.

When a displacement event qualifies, the script can recolor the candle and assign a quality tag. The quality tag reflects the combined strength of the measured conditions rather than a single-factor reading. The script then builds a reclaim zone tied to that displacement structure and extends it forward so later interaction can be monitored on the chart.

Signals & Alerts

The script is built around bullish and bearish displacement detection. When the selected conditions are met, the chart can display a quality tag and the displacement candle can be visually emphasized. Reclaim zones are then plotted so the user can follow the area after the impulse.

Bullish and bearish alerts can be used to notify the user when a qualified displacement event appears. These alerts are intended to identify the script’s filtered displacement conditions, not to predict the full future path of price. In practice, they are most useful as chart-review prompts or workflow triggers rather than as stand-alone trade instructions.

Key Inputs

Users can customize the strictness and presentation of the model through inputs such as:

- Body expansion sensitivity relative to ATR
- Body expansion sensitivity relative to average candle body
- Marubozu proximity threshold
- Optional volume confirmation
- Candle recoloring
- Quality tag visibility
- Reclaim zone visibility and extension length
- Panel font size
- Label font size
- General visual display preferences

These controls allow the script to be tuned for more aggressive discovery or more selective filtering depending on instrument behavior and timeframe.

Limitations & Transparency

This script does not claim to identify every important move, nor does it assume that every qualified displacement event will lead to continuation. Some valid expansion candles can fail quickly, while some useful moves may be excluded if the filters are set too strictly. That trade-off is part of any selective model.

Reclaim zones are analytical reference areas, not guarantees of support or resistance. Price may react, ignore the zone, briefly interact with it, or invalidate it entirely. The script is designed to visualize these areas in a structured way, but interpretation remains with the user.

Results can vary materially across assets, sessions, volatility regimes, and timeframes. Thresholds that work well on one instrument may be too loose or too strict on another. Users should expect to calibrate settings rather than assume one configuration is universally optimal.

As with most chart tools, visual density can increase if many qualifying events occur in the same region. The script includes hierarchy-oriented visual handling, but it is still best used with sensible chart context and reasonable parameter choices.

Risk Disclosure

This script is an analytical charting tool. It is not financial advice, not a promise of performance, and not a guarantee of future results. It does not know the user’s objectives, risk tolerance, execution quality, or portfolio constraints.

Displacement, momentum expansion, and reclaim behavior can all be useful concepts in market analysis, but none of them remove uncertainty. Users should apply their own process, risk controls, and independent judgment before acting on any chart observation generated by this script.
Informacje o Wersji
UPDATE NOTES — V1.3

This update focuses on visual balance, chart readability, and presentation discipline while preserving the core purpose of the script.

AG Pro Displacement Quality Finder continues to identify strong displacement candles through a rules-based structure built around body expansion, ATR comparison, average body comparison, wick efficiency, close location, break confirmation, and optional volume confirmation. The objective of this release was not to turn the script into a different product, but to refine how signals, reclaim context, and reaction zones are displayed so the chart remains easier to read during live use.

What changed in this update

• Refined reclaim label usage
Reclaim labels were reviewed to reduce unnecessary visual competition with the main displacement labels. The chart now places greater emphasis on the displacement event itself while still preserving reclaim context where it is relevant. This helps the user distinguish the primary signal from the follow-up reaction without overloading the screen.

• Cleaner hierarchy between displacement tags and reclaim tags
The main DQ labels remain the dominant visual element because they represent the original qualifying event. Reclaim labels now play a more supportive role. This improves first-glance interpretation and makes the structure easier to understand on both zoomed-in and medium-range chart views.

• Zone borders were softened for a cleaner chart appearance
The reclaim zone borders were reduced slightly in visual weight. This was done to keep the zones visible without allowing them to dominate price action. The result is a more refined balance between price candles, active zones, labels, and the panel.

• Improved zone presentation quality
The active zone stack remains visible, but the overall visual pressure on the chart has been reduced. This makes clustered areas easier to read, especially when multiple bullish or bearish reclaim zones are nearby.

• Panel layout was tightened
The panel was kept functionally rich, but the internal structure was adjusted to feel more compact and organized. Instead of expanding unnecessarily, the panel now presents key information in a denser and more polished form, improving readability while respecting screen space.

• Range and follow-through context remains available in a more efficient format
Additional analytical context remains accessible through the panel, but in a format that is more efficient from a visual standpoint. This allows the script to retain useful state information without making the panel feel oversized.

• Label and zone balance was improved for zoomed chart views
This release also pays particular attention to how the script behaves when the chart is manually zoomed. Labels, zones, and the panel now coexist more cleanly, which helps reduce the impression of crowding during close inspection.

Why this update was made

The previous version already had a solid analytical foundation, but the chart could become visually heavy in certain sections where displacement tags, reclaim tags, and multiple active zones appeared together. This update is designed to improve chart ergonomics and reduce friction in manual review.

The main goal was to preserve informational depth while making the display more selective and more professional. In other words, the script should still provide context, but not at the cost of chart clarity.

What did not change

• The script remains a rules-based displacement analysis tool.
• The script still evaluates displacement quality using the same broader methodology built around expansion, close efficiency, break behavior, and optional participation metrics.
• The update does not claim predictive certainty.
• The script does not guarantee continuation, reversal, or trade outcome.
• The script is still intended for structured chart analysis, alert workflow support, and context building.

Interpretation guidance

A high-quality displacement signal should still be interpreted as a strong contextual event, not as a standalone trade command. Reclaim zones and reclaim labels can help users evaluate whether the market is respecting the area associated with the original displacement candle, but they should be read together with trend structure, liquidity context, session behavior, and general market conditions.

This is especially important because strong displacement can appear in both continuation and reaction environments. For that reason, the update places emphasis on clearer visual hierarchy rather than adding unnecessary visual complexity.

Practical result of this version

In practical chart use, V1.3 should feel cleaner, more controlled, and more deliberate. Signals remain visible. Zones remain useful. Reclaim information remains present. But the overall presentation is now better aligned with a premium charting workflow where the user can interpret structure quickly without the display becoming unnecessarily dense.

Limitations and transparency

This script is not a forecasting engine, not an automated trading system, and not a substitute for full market context. Displacement quality is a filtered condition, not a promise of follow-through. Reclaim behavior can add useful confirmation, but no single label, score, or zone should be treated as sufficient on its own.

As always, thresholds, filters, and visual settings should be adjusted to fit the instrument, timeframe, and chart density preferences of the user.

End result

V1.3 is primarily a chart-quality and usability refinement. The analytical identity of the script remains intact, while the visual delivery is now more disciplined, more selective, and more suitable for cleaner publication-grade presentation.
Informacje o Wersji
Release Notes — v2.0 (AGPro Visual Refresh)

— Visual system rebuilt on the unified AGPro palette (brand / panel / state / accent tokens).
— Panel header upgraded to a single merged row with the standard blue AGPro brand bar.
— Panel position, theme (Dark / Light) and font size are now user-configurable; default font is Normal.
— Label and help-text font sizes standardised to Normal and unified across the script.
— Label stacking and ATR-based vertical offset increased to prevent overlap with price action.
— Reclaim zones extended (up to 160 bars) for cleaner, S/R-style rectangles; midline switched to a dotted accent style.
— Signal thresholds lightly tightened (tag ≥ 72, zone ≥ 78) for a more premium, less crowded chart.
— Full English tooltips added to every input for clarity and professional onboarding.
— Internal color system consolidated from 17+ constants to core palette tokens, reducing dead references.
— Multi-branch opacity logic refactored into dedicated helper functions for speed and parser safety.
— Variable and function names cleaned up; obsolete state tracking removed.
— MPL 2.0 license notice and standard AGPro header block added.
— No feature regressions. All detection logic, quality scoring, follow-through tracking and alert conditions preserved.

Wyłączenie odpowiedzialności

Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.