# overview

## The Philosophy

Most indicators fail not because they are wrong, but because they are used alone. A single Momentum reading, a single Volatility cross, or a single Order Flow spike can easily be a false positive in choppy or manipulated markets.

Synergy Signal is built on a different premise: **require agreement**. Each of the four pillars operates independently. The signal engine counts how many agree in the same direction, and only fires when the count meets your minimum threshold.

This means you will see fewer signals — but the ones you do see carry the weight of multiple confirming factors.

***

## The Four Pillars

### 🔵 Expansion Wave

Measures how far price is breaking outside its expected statistical range (based on a standard deviation envelope). A bullish Expansion Wave means price is pushing above the upper band with sustained force. A bearish Expansion Wave means price is collapsing below the lower band.

The Expansion Wave value is rendered as a **cyan/teal fill** on the oscillator — brighter at the extremes, fading toward the midline at 50.

### 🟣 Momentum

An RSI-based line (default 21-period) that tracks the underlying directional strength. For a long signal, the indicator looks for:

* The Momentum line recently touched or crossed the **Momentum Oversold** level (default 30)
* Momentum is now **rising**
* Momentum has recovered **above its own moving average**

The opposite logic applies for shorts. The Momentum line is shown in **purple**.

### 🟠 Volatility

A Stochastic RSI-based line that tracks short-term exhaustion. It tells you whether momentum is entering from a depleted (oversold) or exhausted (overbought) state — a key filter to avoid chasing into extended moves.

The Volatility line is shown in **orange**.

### 🟢/🔴 Order Flow

Cumulative Volume Delta — the difference between estimated buying and selling volume — normalized and z-scored so it is comparable across assets and timeframes. Rising, positive Order Flow confirms buy-side dominance. Falling, negative Order Flow confirms sell-side dominance.

Order Flow is shown as **green or red bars** centered at the 50 midline.

***

## Signal Logic at a Glance

**LONG signal fires when:**

* ✅ Expansion Wave is bullish (expanding upward)
* ✅ Momentum line is recovering from Oversold zone
* ✅ Order Flow is rising (buy pressure increasing)
* ✅ Volatility line is not overbought
* ✅ Divergence detected (optional soft score boost)
* ✅ Score ≥ Base Min Score (Long)
* ✅ Momentum not in the Chop Zone
* ✅ Regime Filter allows longs (if enabled)
* ✅ Cooldown has elapsed since last signal

Each of these conditions can be tuned or toggled. The **Base Min Score** is the primary dial for controlling signal frequency vs. quality.

***

## Panel Layout

The indicator plots in a **separate oscillator panel** below the price chart. Here is what you will see:

| Element                | Color        | Meaning                                    |
| ---------------------- | ------------ | ------------------------------------------ |
| Blue fill (lower half) | Cyan/teal    | Bullish Expansion Wave strength            |
| Blue fill (upper half) | Cyan/teal    | Bearish Expansion Wave strength            |
| Purple line            | Purple       | Momentum                                   |
| Yellow line            | Yellow       | Momentum moving average                    |
| Orange line            | Orange       | Volatility                                 |
| Green/red bars         | Green/Red    | Order Flow                                 |
| Green dot (bottom)     | Bright green | Long entry signal                          |
| Red dot (top)          | Red          | Short entry signal                         |
| Dashed lines           | Green/Red    | Momentum Oversold (30) / Overbought (70)   |
| Solid lines            | Green/Red    | Volatility Oversold (20) / Overbought (80) |
| Dotted lines           | Dim white    | Chop Zone Low (35) / Chop Zone High (65)   |


---

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