# troubleshooting

<details>

<summary>No Signals Are Appearing</summary>

**Check these in order:**

1. **Are all pillars enabled?** Go to each section (Volatility, Momentum, Expansion, Order Flow) and confirm the "Enable" toggle is on.
2. **Is the Base Min Score too high?** If only 2 pillars are enabled but Base Min Score is 3, no signals can fire. Enable **Score Pillars** to auto-cap the threshold to the number of active pillars.
3. **Is the Regime Filter blocking all entries?** If the Expansion Wave is weak or ranging, neither `bullOK` nor `bearOK` will be true. Try temporarily disabling the Regime Filter to see if signals appear.
4. **Is the Cooldown too long?** A very high Cooldown value can prevent signals from resetting. Try reducing Cooldown bars to 0 temporarily to test.
5. **Is the Momentum line stuck in the Chop Zone?** If Momentum has been between 35 and 65 for an extended period, Block Chop Zone suppresses all signals. This is intentional — wait for Momentum to exit the chop zone.

</details>

<details>

<summary>Too Many Signals</summary>

1. **Raise the Base Min Score** from 2 to 3 for both Long and Short.
2. **Enable the Regime Filter** if it is currently off.
3. **Widen the Chop Zone** (e.g., 40/60 instead of 35/65).
4. **Increase the Cooldown** from 10 to 15–20 bars.
5. **Enable "Only plot on state change"** if it is currently off — this alone can dramatically reduce dot count.

</details>

<details>

<summary>Signals Appear But Quality Is Low</summary>

1. **Check your timeframe.** Signals calibrated for 1H may look noisy on 5m. Default settings are optimized for 1H crypto.
2. **Enable the Regime Filter.** Counter-trend signals are inherently less reliable. The Regime Filter prevents these.
3. **Raise Min Divergences Required** to 2 — requiring more divergence types to agree filters out weaker setups.
4. **Check the Order Flow pillar.** If you are on a non-BTC asset, Order Flow is using BTC volume. Disable Order Flow and see if signal quality improves with the remaining pillars.

</details>

<details>

<summary>Order Flow Bars Are Always Flat / Tiny</summary>

This usually happens when:

* **The asset is not BTC.** The indicator aggregates volume from BTC markets on Binance, Coinbase, and Kraken. On altcoin charts, Order Flow reflects BTC volume, which is still useful for macro context but may produce bars that don't visually match the asset's own price action.
* **Very short timeframes** where individual bar volume is small relative to the z-score normalization window, making normalized values appear compressed.

**Fix:** Disable Order Flow (Enable Order Flow toggle off) and rely on Expansion Wave, Momentum, and Volatility.

</details>

<details>

<summary>Dots Appear in the Middle of the Panel Instead of Top/Bottom</summary>

This is not a bug. The dots use `location.top` and `location.bottom` which places them at the top and bottom of the **indicator pane itself**, not the price chart. If your indicator pane is very short or compressed, top and bottom may appear close together. Resize the indicator pane by dragging its border downward to give it more height.

</details>

<details>

<summary>"Only Plot on State Change" Is On But No Dot Appeared</summary>

This happens when:

* A signal condition is met but the **Cooldown** has not elapsed since the last flip.
* The **position state is already in that direction** — e.g., already long, and the long condition is true again. No flip occurs, so no dot is drawn.

This is intentional. The state machine only fires a dot on a **direction change**, not on a continuation of the same signal.

</details>

<details>

<summary>Divergence Is Enabled But Doesn't Seem to Be Adding to the Score</summary>

1. **Check Divergence Fresh Bars.** If set to 0, divergence only counts on the exact bar of the pivot — but pivots are confirmed 2 bars after they form, meaning the boost is already expired. Set Fresh Bars to at least 10.
2. **Check Min Divergences Required.** If set to 2 or 3, a single divergence type will not activate the pillar. Lower to 1 to verify divergences are being detected at all.
3. **Check the Max Div Age.** Both pivots must have occurred within the last 120 bars. If the chart has not had two qualifying pivots in that window, no divergence is detected.

</details>

<details>

<summary>The Indicator Loads Slowly</summary>

The Order Flow calculation pulls volume data from three external symbols via `request.security()` calls (Binance, Coinbase, Kraken). On some systems or symbols, this can slow the initial load.

* If performance is an issue, **disable Order Flow** (Enable Order Flow toggle off) to remove the three external data requests.
* After the first full load, TradingView typically caches the security requests and subsequent reloads are faster.

</details>

<details>

<summary>The Momentum Trend Filter Lines Are Appearing Unexpectedly</summary>

If you see two additional lines on the oscillator (white and yellow pivot-smoothed lines), the **Momentum Trend Filter** has been enabled in the Momentum Filter (Pivots) section. This is an advanced feature that is off by default.

To hide these lines: go to Settings → Inputs → Momentum Filter (Pivots) → uncheck **Momentum Trend Filter**. Alternatively, hide the lines in the Style tab without disabling the filter logic.

</details>


---

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