WPR Williams Percent Range All PairTF Scanner Dash
- Göstergeler
- Sürüm: 1.0
- Etkinleştirmeler: 5
WPR Williams Percent Range All Pair Timeframe Scanner Dashboard
Overview
WPR Scanner Dashboard Pro is a multi-symbol, multi-timeframe market scanning indicator and visual chart overlay utility built for MetaTrader 4 (MT4). The tool monitors Williams Percent Range (WPR) momentum exhaustion and threshold breakouts across multiple currency pairs, metals, indices, and CFDs simultaneously from a single chart window. In addition to its core WPR detection engine, the indicator incorporates an optional 15-module technical confirmation suite and an Average True Range (ATR) risk-to-reward projection module that automatically calculates Entry, Stop Loss (SL), Take Profit 1 (TP1), and Take Profit 2 (TP2) price levels for every validated setup.
Operating Principle and Signal Logic
To maintain transparent technical operation without exposing proprietary internal state-machine mechanics, the indicator evaluates market data using the following structured workflow:
- Two-Stage Williams Percent Range Confirmation: The scanner monitors closed-bar WPR oscillator values for extreme oversold or overbought excursions followed by a directional threshold breakout. A bullish setup requires the oscillator to first reach or dip below the oversold trigger level (default -80.0) and subsequently cross upward above the bullish execution level (default -55.0). A bearish setup requires the oscillator to first reach or rise above the overbought trigger level (default -20.0) and subsequently cross downward below the bearish execution level (default -45.0).
- Closed-Candle Calculation and Non-Repainting Behavior: All oscillator comparisons, filter evaluations, and volatility calculations are performed strictly on completed candles (Bar 1 and earlier). Once a bar closes and a signal is registered, its timestamp, entry reference price, and projected SL/TP levels remain locked on that historical candle and do not repaint or shift retroactively.
- Modular Multi-Filter Confluence Gate: Before any WPR breakout is accepted as a valid signal, it is passed through an integrated confirmation engine containing 15 independent technical filters. Traders can leave all filters disabled for pure WPR scanning or activate any combination of trend, momentum, volatility, and price-structure filters; a signal is displayed only when every active filter agrees with the signal direction on the closed trigger candle.
- Volatility-Adjusted ATR SL and Dual TP Levels: When a signal passes all active criteria, the indicator reads the ATR value at the signal bar to compute a dynamic Stop Loss distance (ATR multiplied by a user-defined factor) and projects two structured Risk-to-Reward targets (TP1 and TP2) from the signal candle closing price.
- Directional Filtering and Lookback Control: Users can restrict scanning to bullish signals only, bearish signals only, or bidirectional setups within a defined historical lookback window so the dashboard displays relevant recent opportunities.
Key Technical Features
- Multi-Pair and Multi-Timeframe Matrix Scanner: Scans custom symbol lists or active Market Watch instruments across selected timeframes (from M1 to MN1) on an automated timer cycle.
- Interactive Draggable and Collapsible Interface: Features click-and-drag title bar positioning, a one-click collapse/expand toggle (MIN/MAX), a manual rescan trigger (REFRESH), an object cleanup button (CLEAR), and persistent screen position memory across timeframe switches.
- Multi-Column Table Sorting: Clicking the PAIR, TF, DIR, or TIME column headers sorts active signals in ascending or descending order.
- One-Click Chart Switching and Visual Overlay: Clicking the OPEN button on any dashboard row switches the current chart to the corresponding symbol and timeframe while plotting directional arrows, Entry lines, SL lines, and TP1/TP2 projection levels.
- Built-In 15-Filter Confirmation Framework: Includes 15 self-contained technical filter modules (RSI Cross, ADX, Single MA, Ichimoku Senkou Span B, RSI 75, Double MA, Awesome Oscillator, Parabolic SAR, Heiken Ashi, CCI Trend, CCI OB/OS, RVI Trend and Signal, MACD Histogram and Zero Line, Support/Resistance and Fibonacci Retracement, and ATR Supertrend) with zero external indicator dependencies.
- Multi-Channel Real-Time Notifications: Supports MetaTrader pop-up alerts, custom WAV sound alerts, mobile push notifications via MetaQuotes ID, and SMTP email alerts with duplicate-alert prevention.
Dashboard Interface and Visual Color Guide
The on-chart scanner table organizes active setups into 11 structured columns with hover tooltips showing complete trade metrics:
- PAIR and TF: Displays the instrument symbol and timeframe where the signal occurred.
- DIR: Displays BUY in bright green (InpColBull) for bullish breakouts or SELL in coral red (InpColBear) for bearish breakouts.
- TIME and AGE: Displays the exact broker timestamp of the closed signal bar and the elapsed duration since signal confirmation (in seconds, minutes, hours, or days).
- ENTRY, SL, TP 1, and TP 2: Displays normalized price levels for the signal candle close (royal blue on chart), ATR-based Stop Loss (coral red), first Risk-to-Reward target (medium green), and second Risk-to-Reward target (bright green).
- WPR: Displays the exact oscillator reading at the confirmation candle.
- OPEN: Interactive action button highlighted in cyan accent (InpColAccent) that loads the symbol and timeframe onto the active chart.
- Muted Slate Gray (InpColMute): Indicates empty rows when unpopulated pairs are shown, secondary status metrics, and interface hints.
Multi-Filter Confirmation Modules Overview
Each of the 15 optional filter modules can be enabled independently in the Inputs tab:
- 1. RSI Cross Filter: Confirms bullish momentum when RSI crosses upward out of the oversold zone and bearish momentum when RSI crosses downward out of the overbought zone.
- 2. ADX Filter: Requires the Average Directional Index main line to exceed a minimum threshold to confirm sufficient trend strength.
- 3. Single MA Filter: Requires price to close above a Moving Average for bullish signals or below it for bearish signals.
- 4. Ichimoku Senkou Span B Filter: Uses the Ichimoku Kinko Hyo Senkou Span B baseline as a long-term directional equilibrium filter.
- 5. RSI 75 Filter: Evaluates a 75-period RSI relative to the 50.0 midline to align entries with broader directional bias.
- 6. Double MA Filter: Requires fast Moving Average alignment above slow Moving Average for buys and below for sells.
- 7. Awesome Oscillator Filter: Filters signals using Awesome Oscillator histogram magnitude, bar-to-bar color/slope momentum, and zero-line polarity.
- 8. Parabolic SAR Filter: Validates bullish setups only when price closes above Parabolic SAR dots and bearish setups when price closes below.
- 9. Heiken Ashi Filter: Requires smoothed Heiken Ashi candle close above open for bullish signals and close below open for bearish signals.
- 10. CCI Trend Filter: Checks Commodity Channel Index polarity relative to the zero line over a longer lookback period.
- 11. CCI OB and OS Filter: Evaluates short-period CCI momentum zones relative to upper and lower threshold levels.
- 12. RVI Filters: Provides both a long-period Relative Vigor Index zero-line trend filter and a main-versus-signal line alignment filter.
- 13. MACD Filters: Validates setups against MACD histogram polarity and MACD main line position relative to the zero line.
- 14. Support/Resistance and Fibonacci Filters: Checks whether price action interacts with dynamic swing Support/Resistance zones or automated ZigZag Fibonacci retracement bands.
- 15. Supertrend Filter: Uses an ATR-based Supertrend volatility band calculation to confirm prevailing uptrend or downtrend direction.
Trading Recommendations and Resource Management
- Recommended Instruments: Tested on major and cross Forex pairs (EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD, USDCHF, NZDUSD, EURJPY, GBPJPY) and Gold (XAUUSD). It can be applied to any liquid symbol in MetaTrader 4; verify broker-specific symbol prefixes or suffixes when entering custom lists, or set InpUseWatch to true to scan active Market Watch symbols automatically.
- Recommended Timeframes: Compatible with all standard MT4 timeframes. M5 and M15 are suited for intraday scanning, M30 and H1 for day trading workflows, and H4 or D1 for swing trading analysis.
- Account Environment: Works on all standard MetaTrader 4 account types. Low-spread ECN or Raw accounts are recommended so ATR-calculated Stop Loss and TP1 targets remain proportionate to transaction costs.
- CPU and Memory Efficiency: Scanning multiple instruments and timeframes concurrently requires historical bar synchronization. To keep terminal CPU and RAM usage low, the indicator caches filter states per symbol/timeframe slot and limits bar copying via InpBarsCopy (default 120 bars) and InpMaxSymbols (default 10 pairs). Keep InpMaxSymbols between 10 and 20 and avoid attaching multiple scanner instances across numerous open charts on lower-specification computers.
Input Parameters Documentation
WPR Entry Logic Settings:
- InpWPRPeriod (Default: 14) - Number of bars used to calculate the Williams Percent Range oscillator.
- InpBuyTouchLevel (Default: -80.0) - Oversold trigger threshold that arms a potential bullish setup when WPR touches or drops below this value.
- InpBuyBreakLevel (Default: -55.0) - Bullish execution threshold; a Buy signal triggers when an armed WPR crosses upward to or above this level.
- InpSellTouchLevel (Default: -20.0) - Overbought trigger threshold that arms a potential bearish setup when WPR touches or rises above this value.
- InpSellBreakLevel (Default: -45.0) - Bearish execution threshold; a Sell signal triggers when an armed WPR crosses downward to or below this level.
Scanner Settings:
- InpSymbols (Default: "EURUSD,GBPUSD,USDJPY,AUDUSD,USDCAD,USDCHF,NZDUSD,EURJPY,GBPJPY,XAUUSD") - Comma-separated list of symbols to scan when InpUseWatch is disabled.
- InpTimeframes (Default: "M5,M15,M30,H1,H4") - Comma-separated list of timeframes scanned for each symbol.
- InpUseWatch (Default: true) - Enables automatic scanning of symbols currently visible in the Market Watch window.
- InpMaxSymbols (Default: 10) - Maximum number of symbols processed simultaneously by the scanner engine.
- InpScanSec (Default: 7) - Timer refresh interval in seconds between full multi-pair scan cycles.
- InpBarsCopy (Default: 120) - Number of historical candles copied per symbol and timeframe for indicator and filter calculations.
- InpLookback (Default: 100) - Maximum number of closed bars backward from Bar 1 searched for the most recent valid signal.
- InpDirection (Default: 0) - Directional scan filter (0 = Both Buy and Sell, 1 = Buy signals only, 2 = Sell signals only).
ATR SL and TP Settings:
- InpATRPeriod (Default: 14) - Number of bars used for Average True Range volatility measurement.
- InpATRMultSL (Default: 1.5) - Multiplier applied to the signal candle ATR value to determine Stop Loss distance.
- InpTP1_RR (Default: 1.0) - Risk-to-Reward multiplier relative to SL distance for calculating Take Profit 1.
- InpTP2_RR (Default: 2.0) - Risk-to-Reward multiplier relative to SL distance for calculating Take Profit 2.
Alerts and Notifications:
- InpAlertPopup (Default: false) - Enables native MetaTrader pop-up alert windows when a valid signal is detected.
- InpAlertSound (Default: false) - Enables audible WAV sound playback upon signal detection.
- InpSoundFile (Default: "alert.wav") - Name of the audio file located in the MetaTrader Sounds directory.
- InpAlertPush (Default: false) - Sends push notifications to the mobile MetaTrader app via MetaQuotes ID.
- InpAlertEmail (Default: false) - Sends signal details via email using the terminal SMTP configuration.
- InpEmailSubject (Default: "WPR Scanner Signal") - Prefix text used in the subject line of outgoing alert emails.
- InpAlertOnlyNew (Default: false) - Restricts notifications strictly to newly formed signal timestamps newer than previous alerts.
Display and Layout Settings:
- InpX (Default: 12) - Initial horizontal X coordinate of the dashboard panel in pixels from the upper-left chart corner.
- InpY (Default: 28) - Initial vertical Y coordinate of the dashboard panel in pixels from the upper-left chart corner.
- InpScale (Default: 100) - Overall dashboard interface scaling factor in percent (range 70 to 180).
- InpRowH (Default: 18) - Base height of each table row in pixels.
- InpFont (Default: 8) - Base font size in points for dashboard text elements.
- InpPadX (Default: 8) - Inner horizontal left and right margin padding in pixels.
- InpWPair (Default: 68) - Width of the PAIR column in pixels.
- InpWTF (Default: 34) - Width of the TF timeframe column in pixels.
- InpWArah (Default: 44) - Width of the DIR signal direction column in pixels.
- InpWTime (Default: 96) - Width of the TIME signal timestamp column in pixels.
- InpWEntry (Default: 64) - Width of the ENTRY price column in pixels.
- InpWSL (Default: 64) - Width of the SL Stop Loss price column in pixels.
- InpWTP1 (Default: 64) - Width of the TP1 price column in pixels.
- InpWTP2 (Default: 64) - Width of the TP2 price column in pixels.
- InpWWPR (Default: 46) - Width of the WPR value column in pixels.
- InpWUmur (Default: 42) - Width of the AGE elapsed duration column in pixels.
- InpWOpen (Default: 44) - Width of the OPEN chart switch button column in pixels.
- InpShowEmpty (Default: false) - Displays symbol/timeframe combinations that currently have no active signal within the lookback window.
- InpMaxRows (Default: 18) - Maximum number of signal rows rendered simultaneously in the dashboard table.
Sorting Options:
- InpSortBy (Default: SORT_TIME) - Default table sorting criterion (SORT_TIME, SORT_PAIR, SORT_TF, or SORT_DIR).
- InpSortNewest (Default: true) - Controls initial sort direction (true places newest signals first).
Chart Overlay Signals:
- InpDrawOnChart (Default: true) - Enables drawing of the active symbol/timeframe signal arrow and price levels on the chart.
- InpShowArrow (Default: true) - Displays Buy or Sell Wingdings arrows at the signal candle.
- InpShowLevels (Default: true) - Displays horizontal projection lines and text labels for Entry, SL, TP1, and TP2.
- InpExtendBars (Default: 25) - Number of bars to the right across which signal projection lines are extended.
- InpArrowCodeBuy (Default: 233) - Wingdings symbol code used for bullish Buy arrows.
- InpArrowCodeSell (Default: 234) - Wingdings symbol code used for bearish Sell arrows.
- InpArrowSize (Default: 2) - Visual size thickness of chart signal arrows.
- InpArrowDistance (Default: 20) - Vertical offset distance between the signal candle price and arrow marker in points.
Color Theme Settings:
- InpColBg (Default: C'18,22,28') - Main dashboard panel background color in RGB format.
- InpColHead (Default: C'32,38,48') - Header bar and button background color in RGB format.
- InpColRow (Default: C'24,28,36') - Even-numbered table row background color in RGB format.
- InpColRow2 (Default: C'28,33,42') - Odd-numbered table row background color in RGB format.
- InpColText (Default: C'220,225,230') - Primary table text color in RGB format.
- InpColBull (Default: C'0,230,118') - Bullish BUY label text color in RGB format.
- InpColBear (Default: C'255,82,82') - Bearish SELL label text color in RGB format.
- InpColMute (Default: C'120,128,140') - Secondary status text and hint color in RGB format.
- InpColAccent (Default: C'0,200,255') - Title bar and active sort accent color in RGB format.
- InpColArrowBuy (Default: C'0,230,118') - Chart Buy arrow color in RGB format.
- InpColArrowSell (Default: C'255,82,82') - Chart Sell arrow color in RGB format.
- InpColEntry (Default: C'41,128,255') - Chart Entry line and text label color in RGB format.
- InpColSL (Default: C'255,82,82') - Chart Stop Loss line and text label color in RGB format.
- InpColTP1 (Default: C'0,200,83') - Chart TP1 line and text label color in RGB format.
- InpColTP2 (Default: C'0,230,118') - Chart TP2 line and text label color in RGB format.
Filter 1 - RSI Cross Filter:
- Use_RSI_Cross_Filter (Default: false) - Enables RSI threshold crossover confirmation on the signal bar.
- RSI_Length (Default: 14) - Number of bars for RSI calculation.
- RSI_Price_Source (Default: PRICE_CLOSE) - Applied price series used for RSI computation.
- RSI_Oversold (Default: 30.0) - Oversold RSI level that must be crossed upward for Buy validation.
- RSI_Overbought (Default: 70.0) - Overbought RSI level that must be crossed downward for Sell validation.
Filter 2 - ADX Filter:
- Use_ADX_Filter (Default: false) - Enables Average Directional Index trend strength validation.
- ADX_Period (Default: 10) - Number of bars for ADX calculation.
- ADX_Min_Level (Default: 20.0) - Minimum required ADX main line value to pass the filter.
Filter 3 - Single MA Filter:
- Use_MA_Filter (Default: false) - Enables single Moving Average price-position trend filtering.
- MA_Period (Default: 50) - Number of bars for the Moving Average.
- MA_Method (Default: MODE_SMA) - Smoothing method (SMA, EMA, SMMA, or LWMA).
- MA_Shift (Default: 0) - Horizontal shift in bars for the Moving Average.
Filter 4 - Ichimoku Senkou Span B Filter:
- Use_Ichimoku_Filter (Default: false) - Enables Ichimoku Senkou Span B baseline filtering.
- Ichimoku_Tenkan (Default: 9) - Tenkan-sen period in bars.
- Ichimoku_Kijun (Default: 26) - Kijun-sen period in bars.
- Ichimoku_SenkouB (Default: 52) - Senkou Span B period in bars.
Filter 5 - RSI 75 Filter:
- Use_RSI75_Filter (Default: false) - Enables long-period RSI 50-level directional bias filtering.
- RSI_Filter_Period (Default: 75) - Number of bars for the trend RSI calculation.
Filter 6 - Double MA Filter:
- Use_DoubleMA_Filter (Default: false) - Enables dual Moving Average trend alignment filtering.
- MA_A_Period (Default: 30) - Period in bars for fast Moving Average A.
- MA_A_Method (Default: MODE_EMA) - Smoothing method for Moving Average A.
- MA_A_Applied (Default: PRICE_CLOSE) - Applied price for Moving Average A.
- MA_A_Shift (Default: 0) - Horizontal shift in bars for Moving Average A.
- MA_B_Period (Default: 140) - Period in bars for slow Moving Average B.
- MA_B_Method (Default: MODE_EMA) - Smoothing method for Moving Average B.
- MA_B_Applied (Default: PRICE_CLOSE) - Applied price for Moving Average B.
- MA_B_Shift (Default: 0) - Horizontal shift in bars for Moving Average B.
Filter 7 - Awesome Oscillator Filter:
- Use_AO_Filter (Default: false) - Enables Bill Williams Awesome Oscillator momentum confirmation.
- Use_AO_Volume_Filter (Default: false) - Requires AO amplitude to exceed minimum Buy/Sell thresholds.
- AO_Buy_Min (Default: 4.0) - Minimum positive AO value required for Buy signals when volume filter is active.
- AO_Sell_Max (Default: -4.0) - Maximum negative AO value required for Sell signals when volume filter is active.
- Use_AO_Color_Filter (Default: false) - Requires rising AO bar for Buy and falling AO bar for Sell.
- Use_AO_Zero_Filter (Default: false) - Requires AO above zero for Buy and below zero for Sell.
Filter 8 - Parabolic SAR Filter:
- Use_SAR_Filter (Default: false) - Enables Parabolic SAR directional stop-and-reverse filtering.
- SAR_Step (Default: 0.02) - Acceleration factor step increment for Parabolic SAR.
- SAR_Maximum (Default: 0.2) - Maximum acceleration factor limit for Parabolic SAR.
Filter 9 - Heiken Ashi Filter:
- Use_HeikenAshi_Filter (Default: false) - Enables smoothed Heiken Ashi candle body polarity confirmation.
Filter 10 - CCI Trend Filter:
- Use_CCI_Filter (Default: false) - Enables Commodity Channel Index zero-line trend filtering.
- CCI_Period (Default: 50) - Period in bars for the CCI trend calculation.
- CCI_Applied (Default: PRICE_CLOSE) - Applied price source for the CCI trend calculation.
Filter 11 - CCI OB and OS Filter:
- Use_CCI_OBOS_Filter (Default: false) - Enables short-period CCI threshold filtering.
- CCI_OBOS_Period (Default: 14) - Period in bars for the CCI OB/OS oscillator.
- CCI_OBOS_Applied (Default: PRICE_CLOSE) - Applied price source for the CCI OB/OS oscillator.
- CCI_Overbought (Default: 100.0) - Upper CCI threshold level.
- CCI_Oversold (Default: -100.0) - Lower CCI threshold level.
Filter 12 - RVI Filters:
- Use_RVI_Filter (Default: false) - Enables Relative Vigor Index zero-line polarity filtering.
- RVI_Period (Default: 75) - Period in bars for the main RVI trend filter.
- Use_RVI_Signal_Filter (Default: false) - Enables RVI main-versus-signal line alignment filtering.
- RVI_Signal_Period (Default: 20) - Period in bars for the RVI signal line comparison.
Filter 13 - MACD Filters:
- Use_MACD_Filter (Default: false) - Enables MACD histogram polarity confirmation (main minus signal).
- MACD_FastEMA (Default: 12) - Fast EMA period in bars for MACD calculation.
- MACD_SlowEMA (Default: 26) - Slow EMA period in bars for MACD calculation.
- MACD_SignalSMA (Default: 9) - Signal line SMA period in bars for MACD calculation.
- MACD_Applied (Default: PRICE_CLOSE) - Applied price source for MACD calculation.
- Use_MACD_Zero_Filter (Default: false) - Requires MACD main line above zero for Buy and below zero for Sell.
Filter 14 - Support/Resistance and Fibonacci Filters:
- Use_SR_Filter (Default: false) - Enables dynamic swing Support and Resistance zone proximity filtering.
- SR_Period (Default: 50) - Lookback period in bars used to identify recent swing highs and lows.
- SR_Zone_Points (Default: 80) - Proximity tolerance band around Support and Resistance levels in points.
- Use_Fib_Filter (Default: false) - Enables automated ZigZag Fibonacci retracement zone filtering.
- Fib_Level_1 (Default: 0.382) - First Fibonacci retracement ratio boundary.
- Fib_Level_2 (Default: 0.618) - Second Fibonacci retracement ratio boundary.
- ZigZag_Depth (Default: 12) - Minimum bar depth required for swing pivot detection.
- ZigZag_Deviation (Default: 5) - Minimum price deviation in points for pivot confirmation.
- ZigZag_Backstep (Default: 3) - Minimum bar spacing between consecutive swing pivots.
Filter 15 - Supertrend Filter:
- Use_Supertrend_Filter (Default: false) - Enables ATR-based Supertrend directional filtering.
- ST_AtrPeriod (Default: 10) - ATR period in bars used to compute Supertrend volatility bands.
- ST_Factor (Default: 3.0) - ATR multiplier factor determining Supertrend band distance from median price.
Risk Disclaimer
Trading foreign exchange, commodities, indices, and other financial instruments carries a high level of risk and may not be suitable for all investors. Past performance or historical signal behavior does not guarantee future results. This indicator is a technical analysis and market-scanning software utility designed to assist traders in visualizing oscillator conditions and volatility levels; it does not provide financial advice or guarantee trading profits. Always test the product thoroughly on a demo account to understand its operational behavior before using it in live market conditions.
