# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.synergysignal.io/confluence-scoring.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.