Advanced Smc Fvg Scanner with Displacement Filter
- Indicators
- Version: 3.0
Below is a fully rewritten, compliant description ready to paste into your MQL5 listing.
---
### Product Description (Copy & Paste)
**SMC Fair Value Gap (FVG) Scanner with Displacement Engine** is a MetaTrader 5 technical indicator designed to identify, filter, and track imbalances using Smart Money Concepts (SMC) price-delivery mechanics.
Standard FVG tools plot every minor gap across all market conditions, creating excessive noise during consolidation. This indicator introduces a multi-tier displacement filter that validates gaps based on candle momentum, physical candle body size, and minimum gap depth. Calculations execute strictly on closed bars to prevent repainting.
---
### Key Detection Logic
The indicator uses a three-tier algorithmic filter to separate high-conviction imbalances from low-volume market friction:
* **Minimum Gap Size Filter:** Calculates the exact distance between the wick of Bar 1 and the wick of Bar 3. Imbalances below your user-defined threshold in points are disregarded.
* **Displacement Candle Threshold:** Evaluates the middle candle (Bar 2). If the candle's price travel does not meet the minimum displacement threshold, no zone is drawn.
* **Body-Only Measurement Mode:** When enabled, momentum is measured strictly from Bar 2's Open to Close rather than High to Low. This filters out candles with large wicks and small bodies (indecision/sweeps) to focus exclusively on directional conviction.
---
### Chart Visuals & Tracking
* **Dynamic Live Extension:** Active, unmitigated FVGs project forward into live price action to serve as reference points for support, resistance, and points of interest (POIs).
* **Automated Mitigation Engine:** Once price action revisits the zone, the extension terminates. The zone shifts to a muted secondary color (e.g., Silver) or can be configured to disappear. Mitigation can be triggered by either a wick touch or a full gap closure.
* **On-Chart Data Labels:** Displays an integrated tag showing the exact gap size in points (e.g., `Bullish FVG [45 pts]`), allowing direct visual comparison of zone weight.
* **Customizable Styles:** Full control over zone fill opacity, border thickness, line styles, and color palettes for both active and mitigated states.
---
### Alert System
All alerts trigger once the setup bar officially closes, eliminating false alarms and repainting:
* Terminal Pop-up alerts with sound
* Push notifications to the MetaTrader 5 mobile application (via MetaQuotes ID)
* Native MT5 desktop email alerts
---
### Input Parameters
**Displacement & Gap Settings**
* `MinGapPoints` — Minimum distance (in points) between Candle 1 and Candle 3 required to plot a gap.
* `MinDisplacementPoints` — Minimum range (in points) required for Candle 2 to qualify as a displacement candle.
* `MeasureBodyOnly` — If `true`, Candle 2 displacement is measured from Open to Close; if `false`, High to Low is used.
* `MitigationType` — Choose mitigation trigger: `Wick Touch` (first contact) or `Full Fill` (complete zone invalidation).
**Visual Settings**
* `ExtendUnmitigated` — Extend active zones to the current candle (`true`/`false`).
* `ShowSizeLabel` — Display point size text on the zone (`true`/`false`).
* `BullishColor` — Fill color for unmitigated bullish imbalances.
* `BearishColor` — Fill color for unmitigated bearish imbalances.
* `MitigatedColor` — Color applied to mitigated zones.
* `ZoneTransparency` — Opacity level of the drawn rectangles (0–255).
* `BorderWidth` — Line thickness for the upper and lower boundary levels.
**Alert Settings**
* `EnableAlerts` — Enable/disable all alert functionality.
* `SendPushNotifications` — Send notifications to mobile MT5 devices.
* `SendEmail` — Forward alert notifications via MT5 mail settings.
* `PlaySound` — Sound alert on new valid zone formation.
---
### Specifications & Recommendations
* **Platform:** MetaTrader 5 (Desktop)
* **Supported Assets:** Forex pairs, Indices, Commodities, Cryptocurrencies, and Synthetic Indices.
* **Recommended Timeframes:** M5 to D1 (customizable for scalping, day trading, or swing trading models).
* **Execution:** Non-repainting; all criteria calculate on bar close (`bar[1]`).
