> For the complete documentation index, see [llms.txt](https://docs.bigbeluga.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bigbeluga.com/ultimate-suite/ultimate-macd-suite/macd-divergence.md).

# MACD Divergence

### What is MACD Divergence?

The MACD Divergence module detects **bullish** and **bearish divergences** between price and the MACD oscillator. These divergences often appear before major price reversals and help traders catch early signals of trend exhaustion.

<figure><img src="/files/bU4J2PxGybCjjitmiUR8" alt=""><figcaption></figcaption></figure>

This is a **non-lagging system**. Divergences are detected in real time and plotted immediately after confirmation, with 1 bar delay.

<figure><img src="/files/HBMt8azcgEm9ys46VgBu" alt=""><figcaption></figcaption></figure>

* **Bullish Divergence**: Price forms a lower low while MACD forms a higher low.
* **Bearish Divergence**: Price forms a higher high while MACD forms a lower high.

Visuals include:

* Divergence lines on the MACD pane
* Optional labels on the price chart

### Hidden Divergence (Trend Continuation)

While regular divergence signals a potential trend reversal, Hidden Divergence is a powerful tool used to identify trend continuation.

&#x20;It suggests that the current trend is gathering strength during a pullback and is likely to resume its original direction.

**How it Works**

* Hidden Bullish Divergence: Occurs during an uptrend. Price forms a higher low, but the MACD oscillator forms a lower low.&#x20;

<figure><img src="/files/gGL9IEXNwenDAVPcblhI" alt=""><figcaption></figcaption></figure>

This indicates that despite a deeper drop in momentum, the price floor is holding higher than before, signalling a high-probability continuation of the move up.

* Hidden Bearish Divergence: Occurs during a downtrend. Price forms a lower high, but the MACD oscillator forms a higher high.&#x20;

<figure><img src="/files/qiUl4LtrXT8E02Llzofi" alt=""><figcaption></figcaption></figure>

This indicates that even though momentum spiked higher, the price failed to break the previous peak, signaling a continuation of the move down.

### Settings

Located in the **MACD Divergence** section of the settings panel:

<div align="left" data-with-frame="true"><figure><img src="/files/98DeTbRn4OQysnw2jGK4" alt=""><figcaption></figcaption></figure></div>

| Setting           | Description                                                                                                                                                          |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Divergence        | Toggle: Enable or disable divergence detection.                                                                                                                      |
| Divergence Length | <p>Length: Defines how far back the system looks for swing points.</p><p>Shorter: Faster, more frequent signals.</p><p>Longer: Slower, more macro-level signals.</p> |
| Regular Bullish   | Sets the color for standard bullish lines and labels (potential reversals).                                                                                          |
| Regular Bearish   | Sets the color for standard bearish lines and labels (potential reversals).                                                                                          |
| Hidden            | Enable or disable detection for Hidden Divergence (trend continuation).                                                                                              |
| Hidden Bullish    | Sets the color for hidden bullish lines and labels.                                                                                                                  |
| Hidden Bearish    | Sets the color for hidden bearish lines and labels.                                                                                                                  |