Omega Divergence Sniper - Inputs Settings Guide

🔢 Installation
🔹 In MetaTrader 5, open File > Open Data Folder, then go to MQL5Indicators.
🔹 Copy the indicator file (OmegaDivergenceSniper_v1.0.ex5, or the .mq5 source) into that folder.
🔹 Back in MetaTrader 5, right-click Indicators in the Navigator window and choose Refresh (or restart the terminal). If you copied the .mq5 file, open it in MetaEditor and press Compile first.
🔹 Enable DLL imports: Tools > Options > Expert Advisors > Allow DLL imports. This is required for the licence check, Telegram alerts and the WEB / TELEGRAM buttons.
🔹 Drag Omega Divergence Sniper from the Navigator onto a chart. On the Common tab, make sure Allow DLL imports is ticked as well.
🔹 On the Inputs tab, enter your licence key in InpLicenseKey, adjust other settings as needed, and click OK.
Note: If the licence cannot be verified, the indicator does not load and the reason is printed in the chart's top-left corner and in the Experts tab (for example, a missing key or DLL imports not being allowed).
The following sections explain every input in the order it appears on the Inputs tab.
🔢 General
🔹 MaxBarsCalc (default: 3000) - Number of most recent bars calculated when the indicator loads. 0 = all available bars. Smaller values load faster and keep chart scrolling smooth; larger values give more history for statistics.
🔢 0. Licence
🔹 InpLicenseKey (default: empty) - Your licence key from eafxstore.com. Spaces are trimmed and letters are converted to upper case automatically. The key is verified when the indicator starts and re-checked every 30 minutes; it is also re-checked immediately if you switch trading account.
If the licence server is temporarily unreachable, the indicator can keep running from the last successful check for a limited grace period (72 hours by default). Keep your computer clock correct - a clock set back in time disables the grace period.
🔢 Language
🔹 Lang (default: LANG_EN) - Interface language. This build is English only, so this setting has no effect.
🔢 Oscillators
Choose which oscillators take part in divergence detection. Disabling an oscillator removes it from confluence counts, statistics and the dashboard (it is shown as "(off)").
🔹 UseRSI (default: true) - Enable RSI divergence detection.
🔹 RsiLen (default: 14) - RSI period (Wilder smoothing). Lower = faster and more sensitive; higher = smoother with fewer divergences.
🔹 UseMACD (default: true) - Enable MACD divergence detection. Uses the MACD line with fixed periods 12 and 26 (not adjustable).
🔹 UseOBV (default: true) - Enable On-Balance Volume divergence detection (based on tick volume).
🔹 UseCVD (default: true) - Enable Cumulative Volume Delta divergence detection. CVD is built from real ticks for recent bars and estimated from OHLC and tick volume for older bars (dashboard shows * when estimated).
🔹 UseMFI (default: true) - Enable Money Flow Index divergence detection.
🔹 MfiLen (default: 14) - MFI period in bars.
🔹 TickHours (default: 24) - How many hours of tick history to load for CVD. Bars older than this use the estimated delta. Larger values give more accurate CVD over more bars but take longer to load and use more memory.
🔹 MaxTicks (default: 1500000) - Maximum number of ticks kept in memory. If more ticks are loaded, only the most recent are kept. Lower it (e.g. 500000) on a VPS or when running many charts.
🔢 Divergence
These inputs control how swings are found and what counts as a divergence.
🔹 PivLen (default: 5) - Number of bars on each side needed to confirm a swing high or low. A signal appears PivLen bars after the swing. Lower = earlier but more (and noisier) signals; higher = fewer, more significant swings. Also the minimum distance between the two swings being compared.
🔹 PivWindow (default: 2) - The oscillator's extreme is searched within ±PivWindow bars of each price swing, because oscillators often peak one or two bars before or after price.
🔹 MaxPivotGap (default: 60) - Maximum number of bars between the two swings that are compared. Swings further apart are ignored.
🔹 TolPriceATR (default: 0.25) - Price tolerance in ATR units. Two swings within 0.25 x ATR are treated as equal (double bottom/top, class B). A new extreme must exceed this distance to count as a lower low or higher high.
🔹 TolOscPct (default: 8) - Oscillator tolerance as a percentage of the oscillator's range over the last 100 bars. Differences smaller than this are treated as equal (class C).
🔹 ShowHidden (default: true) - Detect hidden (trend-continuation) divergences. When false, only regular divergences are detected.
🔹 MinConfluence (default: 1) - Minimum number of oscillators that must agree for a divergence to be recorded at all. Keeping it at 1 gives the statistics the most samples; use MinDrawConf and AlertMinConf to filter what you see and receive.
Class reference
🔹 A - Price: New extreme (lower low / higher high); Oscillator: Fails to confirm
🔹 B - Price: Equal (within TolPriceATR); Oscillator: Fails to confirm
🔹 C - Price: New extreme; Oscillator: Equal (within TolOscPct)
🔹 H (hidden) - Price: Higher low / lower high; Oscillator: Lower low / higher high
🔢 Statistics
Every divergence is followed forward from the close of its confirmation bar to measure whether it worked.
🔹 TargetATR (default: 1.0) - Success target: the move in the signal's direction, in ATR units, that must be reached first.
🔹 StopATR (default: 1.0) - Failure level: the move against the signal, in ATR units. If target and stop are both touched in the same bar, the result is counted as a failure.
🔹 StatBars (default: 20) - Bars allowed for the target or stop to be reached. After that the signal is a timeout and is excluded from win rates.
🔹 MaxHistory (default: 3000) - Number of recent bars in which divergences are detected and evaluated. Should normally be less than or equal to MaxBarsCalc.
🔹 AtrLen (default: 14) - ATR period. ATR is used for price tolerance, targets/stops, arrow and label offsets.
🔢 Multi-timeframe
🔹 MtfPeriod (default: MTF_H1) - Higher timeframe to scan: OFF, M30, H1, H4 or D1. It must be higher than the chart timeframe, otherwise the HTF scan is skipped. The latest bullish and bearish HTF divergences are drawn as dash-dot lines (blue / orange).
🔹 MtfBars (default: 500) - Number of higher-timeframe bars analysed (at least 60 are needed). The HTF scan runs once per new HTF bar. HTF CVD always uses the estimated delta.
🔢 Display
🔹 Theme (default: THEME_DARK) - Chart colour theme: NONE (keep your colours), DARK, MIDNIGHT or LIGHT. Applies background, grid, candle, bid/ask colours and switches the chart to candles.
🔹 RestoreTheme (default: true) - Restore your original chart colours when the indicator is removed.
🔹 ShowLines (default: true) - Draw lines connecting the two price swings of each divergence. Solid = regular, dashed = hidden; thicker for confluence x3 or more.
🔹 MinDrawConf (default: 2) - Lines and labels are drawn only for divergences with at least this confluence. Weaker signals still get an arrow, which keeps the chart clean.
🔹 DrawHidden (default: false) - Draw hidden divergences (arrows, lines and labels). They are still detected and counted in statistics when false.
🔹 LabelStyle (default: LBL_COMPACT) - NONE - no labels; COMPACT - short label such as "RB·A x3"; FULL - adds oscillator names, e.g. "RSI+MACD RB·A x2". Hover for the full description.
🔹 LabelFont (default: 8) - Font size of the chart labels.
🔹 LabelOffsetATR (default: 0.5) - Distance of labels from the swing price, in ATR units, so they do not overlap the candles.
🔹 MaxDraw (default: 12) - Maximum number of recent divergences drawn with lines/labels. Older ones are removed from the chart.
🔢 Dashboard
🔹 ShowDash (default: true) - Show or hide the dashboard panel.
🔹 DashRight (default: false) - Anchor the panel to the right side of the chart (false = left).
🔹 DashX (default: 10) - Horizontal distance in pixels from the chosen side.
🔹 DashY (default: 28) - Vertical distance in pixels from the top.
🔹 DashScale (default: 1.5) - Panel size multiplier. It is reduced automatically if the panel would not fit the chart height or would take more than 45% of the chart width.
🔹 DashFontAdj (default: 1.0) - Fine-tunes text size inside the panel (recommended 0.8 - 1.3).
🔹 DashMinScale (default: 1.0) - Smallest scale the automatic fitting may use (never below 0.55). Lower it if the panel is cut off on a small chart.
Tip: You can drag the panel by its header. The dragged position is saved for that chart and then overrides DashX, DashY and DashRight. To return to the input position, delete the global variables starting with OMDIVE_DASH in Tools > Global Variables (F3).
🔢 Alerts
Alerts are triggered only for signals confirmed on new live bars, never for historical signals found when the indicator loads.
🔹 AlertPopup (default: true) - Show a MetaTrader popup alert.
🔹 AlertPush (default: false) - Send a push notification to the MetaTrader mobile app. Requires your MetaQuotes ID in Tools > Options > Notifications.
🔹 AlertSoundOn (default: false) - Play a sound file on each alert.
🔹 AlertSoundFile (default: alert.wav) - Sound file to play; it must be in the terminal's Sounds folder.
🔹 AlertRegular (default: true) - Alert on regular divergences.
🔹 AlertHiddenD (default: false) - Alert on hidden divergences.
🔹 AlertMinConf (default: 2) - Minimum confluence for chart-timeframe alerts. Set 3 to be alerted only on the strongest signals.
🔹 AlertMtf (default: true) - Alert when a new higher-timeframe divergence appears (not filtered by AlertMinConf).
🔢 Telegram
🔹 TgEnable (default: false) - Send every alert to Telegram as well. Requires Allow DLL imports. When enabled, a TEST TG button appears on the dashboard footer.
🔹 TgToken (default: empty) - Your bot token from @BotFather, e.g. "123456789:AA...".
🔹 TgChatID (default: empty) - The chat, group or channel ID that should receive messages.
How to set up Telegram alerts
🔹 In Telegram, open @BotFather, send /newbot, follow the steps and copy the bot token.
🔹 Open a chat with your new bot and send it any message (for a group, add the bot to the group; for a channel, add it as an administrator).
🔹 Get your chat ID, for example by messaging @userinfobot, or by opening https://api.telegram.org/bot<TOKEN>/getUpdates in a browser and reading the "chat":{"id":...} value.
🔹 Enter the token and chat ID in the indicator inputs and set TgEnable = true.
🔹 Click TEST TG on the dashboard. A confirmation popup tells you whether the test message was sent; if not, check the Experts tab for details.
🔢 About
🔹 AboutWeb (default: https://eafxstore.com) - Address opened by the WEB button on the dashboard.
🔹 AboutTelegram (default: https://t.me/eafxstore6789) - Address opened by the TELEGRAM button on the dashboard (support channel).
🔢 Troubleshooting
🔹 Indicator does not load; message "Please enter your licence key": Enter the key in InpLicenseKey.
🔹 Message about Allow DLL imports: Enable it in Tools > Options > Expert Advisors and on the indicator's Common tab.
🔹 "Cannot reach the licence server": Check your internet connection and firewall. The indicator can continue on the grace period if it was verified recently.
🔹 "System clock check failed": Set your computer date and time correctly (automatic time sync recommended).
🔹 CVD value shows "*": Tick history is not available for that bar; delta is estimated. Increase TickHours or wait for the tick cache to load.
🔹 No HTF information: MtfPeriod is OFF or not higher than the chart timeframe; choose a higher one.
🔹 Too many or too few signals: Adjust PivLen, MaxPivotGap and the tolerances; use MinDrawConf to reduce drawn signals.
🔹 Telegram test fails: Check token, chat ID, that you messaged the bot first, and Allow DLL imports; see the Experts tab.
🔹 Chart loads slowly / high memory: Lower MaxBarsCalc, MaxHistory, MaxTicks or TickHours.









