> For the complete documentation index, see [llms.txt](https://docs.synergysignal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.synergysignal.io/confluence-scoring.md).

# confluence scoring

## Why Confluence?

No single indicator is reliable across all market conditions. Confluence scoring solves this by requiring multiple independent systems to agree before generating a signal. The more pillars that align, the higher the confidence in the setup.

## How Scoring Works

Each enabled pillar contributes **+1** to the score when its condition is met:

| Pillar            | Max Score Contribution            |
| ----------------- | --------------------------------- |
| Expansion Wave    | 1                                 |
| Momentum          | 1                                 |
| Order Flow        | 1                                 |
| Divergence (soft) | Up to 3 (one per divergence type) |

The **maximum possible score** with all pillars enabled and all three divergence types firing is **6** (3 hard pillars + 3 divergence types).

The **Volatility line** does not add to the score — it is a binary gate only.

## The Divergence Score (Soft Pillar)

The Divergence score is "soft" because:

* It can **boost** the score when present
* Its absence **never blocks** a signal
* It can contribute between 0 and 3 points

The three divergence types that can each contribute 1 point:

1. **Momentum Divergence** (Use Momentum Divs)
2. **Expansion Divergence** (Use Expansion Divergence)
3. **Order Flow Divergence** (Use Order Flow Divergence)

A setup with all three hard pillars AND all three divergences would score **6 out of 6**.

## Setting the Minimum Score

The **Base Min Score** settings (Confluence section) control how strict the filter is:

| Base Min Score | Effect                                             |
| -------------- | -------------------------------------------------- |
| 1              | Very permissive — any single pillar fires a signal |
| 2 (default)    | Balanced — requires two pillars to agree           |
| 3              | Strict — requires broad agreement                  |
| 4              | Very strict — near full confluence required        |

There are **separate thresholds** for longs and shorts. You can require Score ≥ 3 for shorts but only ≥ 2 for longs if your bias is bullish, for example.

## Score Pillars (Auto-Scale)

When **Score Pillars** is enabled (Confluence section), the effective minimum score is automatically capped to the number of available hard pillars. This prevents an impossible requirement when some pillars are disabled.

**Example:**

* Order Flow disabled → only 2 hard pillars remain (Expansion Wave, Momentum)
* Base Min Score set to 3
* Auto-Scale caps the effective minimum to **2** so signals can still fire

Without Score Pillars enabled, a Base Min Score of 3 with only 2 pillars enabled would produce **zero signals**.

{% hint style="success" %}
It is strongly recommended to leave **Score Pillars** enabled unless you are intentionally requiring a high divergence score to qualify entries.
{% endhint %}

## Practical Examples

### Example A: Conservative Swing Setup

* Base Min Score Long: **3**
* Base Min Score Short: **3**
* All pillars enabled
* Regime Filter: On
* Min Divergences Required: 2

→ A signal fires only when Expansion Wave + Momentum + Order Flow all agree AND at least two divergence types are present. Very rare, very high conviction.

### Example B: Balanced Default

* Base Min Score Long: **2**
* Base Min Score Short: **2**
* All pillars enabled
* Regime Filter: On

→ Any two of the three hard pillars must agree. Divergence gives a soft boost but is not required.

### Example C: Scalping Mode

* Base Min Score Long: **1**
* Base Min Score Short: **1**
* Expansion Wave disabled
* Regime Filter: Off
* Cooldown: 3 bars

→ Momentum or Order Flow alone can fire a signal. Fast and responsive — use with additional chart context.

## Monitoring the Score Visually

The score is not directly displayed on the chart, but you can infer it by checking the four visual elements:

* 🔵 Is the blue Expansion Wave fill growing in your direction?
* 🟣 Is the purple Momentum line recovering from or rejecting an extreme?
* 🟢/🔴 Are the Order Flow bars strongly colored and growing?
* 🟠 Is the orange Volatility line in a favorable zone (not overbought for longs, not oversold for shorts)?

When all four look aligned, you are likely at or near a maximum score.
