Divergence Matrix Pro User Guide: Multi-Oscillator Divergence Indicator for MT4 and MT5

Divergence Matrix Pro is a confirmed multi-oscillator divergence indicator for MetaTrader 4 and MetaTrader 5. It is designed to help traders identify regular and hidden divergence structures using oscillator agreement, validation filters and compact chart labels.

This guide explains what the indicator shows, how to read the signal labels, how the confirmation model works, and how to use the tool in a practical trading workflow.

MetaTrader 5 version: Divergence Matrix Pro for MT5
MetaTrader 4 version: Divergence Matrix Pro for MT4

1. What the Indicator Does

Divergence Matrix Pro detects divergence between price and selected oscillators. A divergence happens when price and an oscillator do not confirm each other. This can be useful as a warning that momentum is changing, or that a pullback may be losing strength.

The indicator supports four main divergence types:

• Bullish Regular divergence - a potential bullish reversal warning.
• Bearish Regular divergence - a potential bearish reversal warning.
• Bullish Hidden divergence - a possible bullish continuation setup.
• Bearish Hidden divergence - a possible bearish continuation setup.

The indicator does not open trades automatically. It is an analysis and confirmation tool. It should be used together with your own trading rules, risk management, market context and confirmation methods.

2. Signal Codes on the Chart

The default label format is compact but informative. A typical signal label may look like this:

BuR 75 - RSI+Hist

This label contains three parts:

• BuR is the divergence type.
• 75 is the confluence score.
• RSI+Hist shows which oscillators confirmed the setup.

The signal codes are:

• BuR = Bullish Regular divergence
• BeR = Bearish Regular divergence
• BuH = Bullish Hidden divergence
• BeH = Bearish Hidden divergence

If many oscillators confirm the same setup and the label would become too long, the indicator can switch to a shorter format, for example:

BuR 82 - 3 osc

The full oscillator list is available in the object tooltip.

3. Regular Divergence

Bullish Regular Divergence

Bullish Regular divergence usually appears near swing lows. It happens when price creates a lower low, while the oscillator creates a higher low.

Basic interpretation:

• Price is still pushing lower.
• Momentum is no longer confirming the new low.
• This can warn that bearish pressure is weakening.

On the chart, this signal is displayed as BuR.

Bearish Regular Divergence

Bearish Regular divergence usually appears near swing highs. It happens when price creates a higher high, while the oscillator creates a lower high.

Basic interpretation:

• Price is still pushing higher.
• Momentum is no longer confirming the new high.
• This can warn that bullish pressure is weakening.

On the chart, this signal is displayed as BeR.

4. Hidden Divergence

Bullish Hidden Divergence

Bullish Hidden divergence is usually used as a continuation signal in an uptrend. It happens when price creates a higher low, while the oscillator creates a lower low.

Basic interpretation:

• Price holds above the previous swing low.
• The oscillator pulls back more deeply.
• This can suggest that the bullish structure is still intact.

On the chart, this signal is displayed as BuH.

Bearish Hidden Divergence

Bearish Hidden divergence is usually used as a continuation signal in a downtrend. It happens when price creates a lower high, while the oscillator creates a higher high.

Basic interpretation:

• Price fails to break above the previous swing high.
• The oscillator moves higher during the pullback.
• This can suggest that the bearish structure is still intact.

On the chart, this signal is displayed as BeH.

5. What the Score Means

The number after the signal code is a confluence score. It is not a win rate. It is not a probability. It is not a guarantee.

The score is designed to help compare signal quality based on several technical factors, such as:

• How many enabled oscillators confirm the same divergence.
• The quality of the price movement between pivots.
• The distance between the pivots.
• Whether the price line validation is passed.
• Whether the oscillator line validation is passed.

A higher score means the detected divergence has stronger technical confluence according to the indicator logic. It does not mean that the trade will win.

6. Confirmed Closed-Bar Logic

Divergence Matrix Pro uses a confirmed closed-bar model. This means the indicator does not create signals on the current forming candle. A divergence pivot is confirmed only after a defined number of bars to the right has closed.

The default setting uses 2 right-side bars. This gives a faster confirmed signal than a very conservative pivot setting, while still avoiding unstable current-bar signals.

The indicator uses a two-layer visual model:

• Pivot label - drawn on the divergence pivot candle after confirmation. It shows where the divergence structure occurred.
• Action marker - drawn on the confirmation candle. This is where the confirmed signal becomes available.
• Buffers and alerts - produced on the confirmation candle, not on the pivot candle.

This design avoids look-ahead behavior for EA and backtesting, while still keeping the divergence structure visually easy to read on the chart.

If you increase Pivot Right Bars, signals become slower but more conservative. If you decrease it, signals become faster but more sensitive.

7. Default Oscillator Setup

The default configuration uses:

• RSI
• MACD Histogram
• Stochastic

The default minimum oscillator agreement is 2. This means a signal should normally be confirmed by at least two enabled oscillators before it is shown.

This default setup is designed to keep the chart clean. Traders who prefer broader confirmation can enable more oscillators from the input settings.

8. Supported Oscillators

Divergence Matrix Pro supports the following oscillator sources:

• RSI
• MACD Main
• MACD Histogram
• Stochastic
• CCI
• Momentum
• MFI
• OBV
• Awesome Oscillator

Using more oscillators can produce more confirmations, but it can also make the chart more active. For most users, it is better to start with the default setup and then adjust gradually.

9. Visual Elements

The indicator can draw several chart elements:

• Divergence line - connects the previous pivot and the current divergence pivot.
• Pivot label - appears on the pivot candle after confirmation and shows signal type, score and oscillator confirmation.
• Action marker - appears on the confirmation candle, where the signal becomes available for alerts and EA buffers.
• Matrix Panel - an optional current-timeframe panel showing recent oscillator confirmation by divergence type.
• Tooltip - provides more detailed information about the signal, including pivot time, confirmation time and confirmation delay.
• Legend - optional explanation of signal codes.

A typical pivot label may look like this:

BuR 75 - RSI+Hist

The label explains the divergence structure. The action marker shows the confirmed signal bar.

If you prefer a clean chart, use fewer visible signals, keep the minimum score filter enabled and keep the default compact label style.

10. Matrix Panel

The Matrix Panel is an optional current-timeframe overview of recent oscillator confirmation. It is designed to help you see which enabled oscillators recently confirmed each divergence type.

The matrix rows represent oscillators, and the columns represent the four divergence types:

• BuR - Bullish Regular
• BeR - Bearish Regular
• BuH - Bullish Hidden
• BeH - Bearish Hidden

An active matrix cell means that the oscillator recently confirmed that divergence type within the configured matrix lookback window. The panel is not a separate trading system. It is a quick visual summary of the current timeframe divergence matrix.

You can hide the panel from the inputs if you prefer a minimal chart.

11. Recommended Workflow

A practical workflow can look like this:

1. Choose the symbol and timeframe you trade.
2. Start with the default indicator settings.
3. Look for confirmed divergence signals near meaningful market structure.
4. Check whether the signal agrees with the broader trend or key support and resistance.
5. Use your own entry trigger, stop loss and risk management rules.
6. Do not trade every signal automatically.

The indicator is best used as a confirmation tool, not as a complete trading system.

12. Example Interpretations

Example 1: BuR 78 - RSI+Hist

This means a Bullish Regular divergence was detected. RSI and MACD Histogram confirmed the same divergence structure. The score is 78, which indicates a stronger confluence than a low-score signal.

Possible use: watch for bullish confirmation, a break of minor structure, support reaction or another entry trigger from your own strategy.

Example 2: BeR 81 - Hist+Stoch

This means a Bearish Regular divergence was detected. MACD Histogram and Stochastic confirmed the setup. This can warn that the current bullish push is losing momentum.

Possible use: watch for bearish confirmation near resistance, trendline rejection, liquidity sweep or your own sell setup.

Example 3: BuH 74 - RSI+Stoch

This means a Bullish Hidden divergence was detected. It can be interpreted as a possible continuation setup if the broader market structure is bullish.

Example 4: BeH 80 - Hist+Stoch

This means a Bearish Hidden divergence was detected. It can be interpreted as a possible continuation setup if the broader market structure is bearish.

13. Alerts

Divergence Matrix Pro supports several alert types:

• Popup alerts
• Push notifications
• Email alerts
• Sound alerts

Alerts are generated from confirmed signals. The alert score filter can be configured separately, so you can choose to receive alerts only for stronger setups.

14. EA Integration

Both the MetaTrader 4 and MetaTrader 5 versions provide 10 buffers for iCustom integration:

• 0 - Bullish Regular price
• 1 - Bearish Regular price
• 2 - Bearish Hidden price
• 3 - Bearish Hidden price
• 4 - Bullish score
• 5 - Bearish score
• 6 - Best signal type
• 7 - Oscillator mask
• 8 - Confirmed signal state
• 9 - Pivot distance

Signals are written at the confirmation bar. The pivot label can appear on the divergence pivot candle visually because it annotates the structure after confirmation, but EA buffers are not written at the pivot candle.

This is important for automation. EA logic should read the confirmation bar, not the pivot label bar. This avoids look-ahead behavior in backtesting and automated workflows.

The Best signal type buffer uses the following values:

• 0 - No signal
• 1 - Bullish Regular
• 2 - Bearish Regular
• 3 - Bullish Hidden
• 4 - Bearish Hidden

The Confirmed signal state buffer uses the following values:

• 0 - No confirmed signal
• 1 - Bullish confirmed signal
• -1 - Bearish confirmed signal
• 2 - Mixed bullish and bearish state on the same confirmation bar

If you call the indicator from an EA with custom inputs, make sure the parameters are passed in the correct input order.

15. Suggested Settings

Clean Default

• RSI: enabled
• MACD Histogram: enabled
• Stochastic: enabled
• Minimum oscillator agreement: 2
• Pivot Right Bars: 2
• Minimum score to show: 60
• Matrix Panel: enabled
• Label style: Type + score + compact oscillators

More Active Matrix

• Enable additional oscillators such as CCI, MFI or AO.
• Keep minimum oscillator agreement at 2 or increase it to 3.
• Increase maximum visible signals only if the chart remains readable.

Conservative Use

• Increase minimum score to show.
• Use fewer oscillators.
• Focus on higher timeframes.
• Combine signals with support, resistance and trend context.

16. Important Notes

• The indicator does not guarantee profitable trades.
• The score is not a win rate.
• Signals appear only after pivot confirmation.
• The pivot label marks where the divergence structure occurred.
• The action marker, buffers and alerts are produced on the confirmation candle.
• The Matrix Panel is a current-timeframe summary, not a separate trading system.
• Regular divergence is often used for reversal warnings.
• Hidden divergence is often used for continuation analysis.
• Always use risk management.

17. Final Thoughts

Divergence Matrix Pro is built for traders who want a structured way to read divergence without filling the chart with excessive noise. It combines confirmed pivot logic, oscillator agreement, validation filters, compact labels and optional alerts into one practical workflow.

Start with the default settings, study how the signals behave on your preferred symbols and timeframes, and then adjust the inputs only when you understand what each change does.

MetaTrader 5 version: Divergence Matrix Pro for MT5
MetaTrader 4 version: Divergence Matrix Pro for MT4