QSS Confluence Engine

QSS Confluence Engine - User Guide

1. System Overview
The QSS Confluence Engine is a sophisticated, multi-layered trading algorithm designed for TradingView (Pine Script v6). Unlike standard indicators that rely on a single data point (like RSI or MACD), QSS aggregates data from five distinct "Engines" to generate high-probability trade signals.
The core philosophy is Confluence: A trade signal is only valid when price structure, volume flow, statistical probability, and momentum cycles align.

2. The Five Core Engines
🔥 A. Signal Engine (The Backbone)
This is the primary trend detector. It determines the bias (Bullish/Bearish).
Modes:

• OTT (Optimized Trend Tracker): Smoother, better for volatile assets (Crypto/Forex).
  

• SuperTrend: Faster, better for trending stocks or scalping.
  

Function:

• If this engine says "Bearish," the system ignores all Buy signals from other modules.
  

🏰 B. Liquidity Structure (Apex Logic)
Identifies "Structural" Support and Resistance based on market pivots.

• Logic: Draws zones from significant Pivot Highs/Lows to the candle body (Wick-to-Body).
  

• Usage: Acts as a filter. The system will block a Buy signal if price is currently smashing into a Supply (Red) Liquidity Zone.
  

🌊 C. Imbalance Engine (BigBeluga Logic)
Identifies "Momentum" Supply/Demand based on volume and candle sequences.

• Logic: Detects aggressive institutional buying/selling (e.g., 3 consecutive green candles with rising volume).
  

• Usage: Shows where "Smart Money" has previously entered. These zones are often more reactive than standard pivots.
  

📊 D. Statistical Engine (Zeiierman Logic)
Calculates the raw mathematical probability of price movement.

• Logic: It tracks every single bar in history. If the last candle was Green, it calculates: "Historically, after a Green candle, how often did price move up another 0.5 ATR?"
  

• Filter: If enabled, it blocks trades where the historical probability of success is < 50%.
  

🧠 E. Neural KDE (Kernel Density Estimation)
Estimates the probability of a market reversal using statistical density.

• Logic: Uses Gaussian math to find "Overextended" states in the RSI.
  

• Usage: Prints Arrow labels when a reversal is statistically likely.
  

3. Configuration Guide (Settings Menu)
Signal Engine

• Strategy Engine: Choose OTT for most assets. Switch to SuperTrend if you want faster, tighter signals.
  

• OTT %: Lower (e.g., 1.0) for scalping, Higher (e.g., 2.0) for swing trading.
  

Liquidity & Imbalance

• Filter: Respect Liquidity Zones: Keep this ON. It prevents buying into resistance.
  

• Show S/D Imbalances: Default is OFF to keep the chart clean. Turn ON to see exactly where institutional volume entered.
  

Statistical Probability
Show Probability Lines: Default is ON.

• Green Line: The price target for a "Bullish" continuation.
  

• Red Line: The price target for a "Bearish" reversal.
  

• Label: Shows the exact % chance (e.g., Prob Up: 65%).
  

Quant Filters

• Koncorde / Institutional Activity: Checks for volume patterns associated with large players.
  

• ADX Filter: Ensures the market is actually trending (ADX > 20) before signaling.
  

• Cycle Filter (STC): A momentum cycle oscillator. Keeps you out of trades when the cycle is exhausted.
  

4. How to Trade (The Strategy)
The Buy Signal (Long)
A BUY label appears only when ALL of the following occur simultaneously:
Trend: The Core Engine (OTT/SuperTrend) turns Green.
Structure: Price is NOT inside a Supply/Resistance zone.
Volume: Volume is above average (if Volume Filter is on).
Probability: Statistical probability of an Up move is > 50%.
Momentum: STC Cycle is moving up.

The Sell Signal (Short)
A SELL label appears when:
Trend: The Core Engine turns Red.
Structure: Price is NOT inside a Demand/Support zone.
Volume: Volume is below average (if Volume Filter is on).
Probability: Statistical probability of a Down move is > 50%.
Momentum: STC Cycle is moving down.

Risk Management (R:R)
The script automatically draws entry, stop-loss, and take-profit lines when a signal fires.

• SL (Stop Loss): Placed at 2.0 x ATR (Average True Range).
  

• TP 1/2/3: Placed at 2x, 4x, and 6x ATR.
  

• Strategy: Close half your position at TP1 and move SL to Breakeven.
  

5. The Dashboard (HUD)
Located at the bottom right, the HUD gives you a comprehensive real-time health check of the asset.

• Current Engine: Displays the active strategy mode (OTT or SuperTrend).
  

• Current Session: Identifies the active market session (London, New York, Tokyo).
  

• Trend Bias: The overall direction (Bullish/Bearish).
  

• Zone Status: Tells you if you are currently blocked by a zone (e.g., LIQ SUPPLY means "Don't Buy, we are at resistance").
  

• KDE Prob: Indicates if a market Top or Bottom is statistically likely based on neural density.
  

• Math Probability: The raw % chance of the current move continuing based on historical analysis.
  

• Inst. Activity: Shows if institutions are Accumulating (Buying) or Distributing (Selling).
  

• Trend Strength: Uses ADX to classify the market as Ranging, Trending, or Parabolic.
  

• Trend Pressure: Shows if momentum is Rising or Falling.
  

• System Status: A vital debugger. It tells you exactly why a trade isn't firing (e.g., "Wait: Cycle", "Wait: Ribbon") or if it's "Scanning...".
  

• Active Trade Data: When a trade is live, this section replaces "System Status" to show Entry Price, Stop Loss, and Take Profit levels
  

6. Troubleshooting

• "No Signals Appearing": You likely have too many filters enabled. Try disabling the Koncorde or Liquidity Filter temporarily to see if signals appear. The stricter the confluence, the fewer (but higher quality) the signals.
  

• "Chart is too messy": Go to settings and uncheck Show Liquidity Zones, Show Probability Lines, or Show KDE Arrows. The logic will still work in the background even if visuals are hidden.