Smart Confluence Signal - Complete User Guide

Overview
How It Works
Signal Types & Patterns
Configuration Guide
Indicator Details
Weight System
Synergy Bonuses
Trading Setup
Best Practices
Troubleshooting

Overview

The Smart Confluence Signal is an advanced trading signal that combines multiple technical indicators into a single, weighted confidence score. Instead of relying on a single indicator, it requires multiple indicators to align before generating a trade signal, significantly reducing false signals.

Key Features

✅ Multi-Indicator Confluence - Combines 11+ technical indicators
✅ Weighted Scoring System - Higher weights for more reliable indicators
✅ Synergy Detection - Bonus points when indicators confirm each other
✅ Context Awareness - Adjusts weights based on market conditions
✅ Configurable Thresholds - Customize sensitivity to your risk tolerance

Philosophy

Quality over Quantity - Only trade when multiple high-confidence signals align, even if it means fewer trades.

How It Works

3-Step Process

Step 1: Individual Signal Detection

Each indicator is checked independently:

Priority Indicators: MTF, CVD, VWAP, OFI, Ichimoku
Core Indicators: RSI, MACD, RSI Divergence, Bollinger Bands
Supporting Indicators: Volume, Momentum, ATR

Step 2: Weight Calculation

Signals that fire receive their base weight:

Example:
✅ ICHIMOKU fires → +16.0 points
✅ MACD fires → +12.0 points
Base Total: 28.0 points

Step 3: Synergy Detection

When indicators confirm each other, bonus points are added:

Example:
ICHIMOKU + MACD synergy → +8.0 bonus
Final Total: 28.0 + 8.0 = 36.0 points

Step 4: Threshold Check

If total weight ≥ threshold (default: 70.0), a signal is generated.

Example Calculation

Indicators Detected:
- MTF (Multi-timeframe alignment): +25.0
- CVD (Strong buying pressure): +22.0
- VWAP (Price at lower band): +20.0

Synergies Detected:
- MTF + CVD + VWAP: +15.0 bonus

Total Weight: 25 + 22 + 20 + 15 = 82.0
Threshold: 70.0
Result: ✅ MTF_CVD_VWAP_LONG_SIGNAL generated

Signal Types & Patterns

Priority Synergy Patterns (Highest Quality)

🏆 MTF_CVD_VWAP (Long/Short)

Weight: ~82 points (67 base + 15 synergy)
Confidence: 85-95%
Description: Triple confirmation from institutional levels, volume pressure, and multi-timeframe alignment
When to Trade: High conviction - all systems aligned
Risk Level: Low (strongest signal)

🏆 OFI_CVD (Long/Short)

Weight: ~52 points (40 base + 12 synergy)
Confidence: 80-90%
Description: Order flow imbalance confirmed by cumulative volume delta
When to Trade: Smart money is active - institutional accumulation/distribution
Risk Level: Low-Medium

🏆 ICHIMOKU_MTF (Long/Short)

Weight: ~51 points (41 base + 10 synergy)
Confidence: 75-85%
Description: Cloud trend confirmed across multiple timeframes
When to Trade: Strong trend with multi-timeframe confirmation
Risk Level: Low-Medium

🏆 VWAP_OFI (Long/Short)

Weight: ~48 points (38 base + 10 synergy)
Confidence: 75-85%
Description: Price at institutional VWAP level with order flow confirmation
When to Trade: Institutional support/resistance with active buying/selling
Risk Level: Medium

🏆 CVD_VOLUME (Long/Short)

Weight: ~41 points (32 base + 9 synergy)
Confidence: 70-80%
Description: Volume delta confirmed by volume surge
When to Trade: Volume breakout with directional bias
Risk Level: Medium

Mixed Priority + Core Patterns

📊 MTF_RSI_DIV (Long/Short)

Weight: ~49 points (40 base + 9 synergy)
Confidence: 75-85%
Description: Multi-timeframe alignment with RSI divergence
When to Trade: Trend reversal with multi-timeframe confirmation
Risk Level: Medium

📊 ICHIMOKU_MACD (Long/Short)

Weight: ~36 points (28 base + 8 synergy)
Confidence: 70-80%
Description: Cloud trend confirmed by MACD momentum
When to Trade: Trend continuation with momentum confirmation
Risk Level: Medium

Core Indicator Patterns

📈 RSI_DIV_MACD (Long/Short)

Weight: ~35 points (27 base + 8 synergy)
Confidence: 70-80%
Description: Divergence confirmed by momentum shift
When to Trade: Momentum reversal signals
Risk Level: Medium-High

📈 VOLUME_BB (Long/Short)

Weight: ~26 points (20 base + 6 synergy)
Confidence: 65-75%
Description: Volume confirms Bollinger Band breakout
When to Trade: Volatility breakout with volume
Risk Level: Medium-High

📈 RSI_BB (Long/Short)

Weight: ~27 points (22 base + 5 synergy)
Confidence: 65-75%
Description: Extreme RSI levels at band boundaries
When to Trade: Overbought/oversold at extremes
Risk Level: Medium-High

Multi-Signal Confirmations

🎯 MULTI_PRIORITY (Long/Short)

Weight: Variable (depends on which 3+ priority indicators align)
Confidence: 80-90%
Description: 3 or more priority indicators aligned
When to Trade: Rare but extremely high confidence
Risk Level: Very Low

🎯 MULTI_CORE (Long/Short)

Weight: Variable (depends on which 3+ core indicators align)
Confidence: 75-85%
Description: 3 or more core indicators aligned
When to Trade: Strong confluence from technical indicators
Risk Level: Low-Medium

Fallback Pattern

⚪ CONFLUENCE (Long/Short)

Weight: Minimum 70.0 (threshold)
Confidence: 60-70%
Description: Multiple indicators aligned but no strong synergies
When to Trade: Minimum viable signal - use with caution
Risk Level: Medium-High

Configuration Guide

Quick Start Configuration

Conservative (Low Risk, Fewer Trades)

min_weight_threshold: 80.0           # Higher threshold = stronger signals required
mtf_min_alignment_score: 0.85        # Require 85% multi-timeframe alignment
ichimoku_min_confidence: 65.0        # Higher confidence required
ofi_aggressive_buy_threshold: 70.0   # Higher order flow threshold

Balanced (Recommended)

min_weight_threshold: 70.0           # Default balanced threshold
mtf_min_alignment_score: 0.80        # 80% multi-timeframe alignment
ichimoku_min_confidence: 55.0        # Standard confidence
ofi_aggressive_buy_threshold: 65.0   # Standard order flow threshold

Aggressive (Higher Risk, More Trades)

min_weight_threshold: 50.0           # Lower threshold = more signals
mtf_min_alignment_score: 0.70        # 70% multi-timeframe alignment
ichimoku_min_confidence: 50.0        # Lower confidence acceptable
ofi_aggressive_buy_threshold: 60.0   # Lower order flow threshold

Essential Settings

Master Switch

enabled_confluence_signal: true      # Enable/disable entire system

Threshold Control

min_weight_threshold: 70.0           # Minimum total weight to generate signal
                                     # Lower = more signals (less selective)
                                     # Higher = fewer signals (more selective)

Conflict Handling

conflicting_signals_penalty: 15.0    # Confidence penalty when opposite signals exist
conflicting_signals_threshold: 30.0  # Minimum opposite weight to apply penalty

Indicator Details

Priority Indicators (Highest Weights)

1. Multi-Timeframe Alignment (MTF)

Weight: 25.0 | Documentation: MTF Guide

What it detects: Trend alignment across short, medium, and long timeframes

Configuration:

mtf_short_term_period: 10            # Short-term: 10 candles
mtf_medium_term_period: 30           # Medium-term: 30 candles
mtf_long_term_period: 50             # Long-term: 50 candles
mtf_min_alignment_score: 0.8         # Require 80% alignment
mtf_min_trend_strength: 2.0          # Minimum 2% price move

When it fires:

✅ All timeframes trending in same direction
✅ Alignment score ≥ 80%
✅ RSI/MACD confirm price trends

Best for: Identifying strong, confirmed trends

2. Cumulative Volume Delta (CVD)

Weight: 22.0 | Documentation: CVD Guide

What it detects: True buying vs selling pressure from order flow

Configuration:

cvd_divergence_lookback: 10          # Lookback for divergence
cvd_strong_buying_threshold: 1000.0  # Adjust per asset
cvd_strong_selling_threshold: -1000.0
cvd_slope_period: 10                 # CVD momentum calculation

When it fires:

✅ CVD slope > threshold (strong buying)
✅ CVD slope < threshold (strong selling)
✅ CVD/price divergence detected

Best for: Detecting institutional accumulation/distribution

Asset-Specific Tuning:

# BTC/USDT (high volume)
cvd_strong_buying_threshold: 1000.0

# ETH/USDT (medium volume)
cvd_strong_buying_threshold: 500.0

# Altcoins (low volume)
cvd_strong_buying_threshold: 100.0

3. VWAP Bands

Weight: 20.0 | Documentation: VWAP Guide

What it detects: Price interactions with institutional reference levels

Configuration:

vwap_std_dev_multiplier: 2.0         # 2 standard deviations
vwap_band_penetration_threshold: 0.5 # Min 0.5% penetration
vwap_enable_band_bounce: true        # Enable bounce signals
vwap_enable_crossover: true          # Enable crossover signals
vwap_min_distance_for_signal: 0.3    # Min 0.3% from VWAP

When it fires:

✅ Price touches upper/lower band (bounce signal)
✅ Price crosses VWAP (trend change)
✅ Distance from VWAP sufficient

Best for: Mean reversion and institutional support/resistance

4. Order Flow Imbalance (OFI)

Weight: 18.0 | Documentation: OFI Guide

What it detects: Aggressive buying/selling from smart money

Configuration:

ofi_lookback: 20                     # Analysis period
ofi_slope_period: 5                  # Momentum period
ofi_aggressive_buy_threshold: 65.0   # Min 65% aggressive buying
ofi_aggressive_sell_threshold: 65.0  # Min 65% aggressive selling
ofi_require_volume_confirmation: true
ofi_min_volume_multiplier: 1.2       # Require 1.2x average volume

When it fires:

✅ Aggressive buying ratio > 65%
✅ Volume > 1.2x average
✅ OFI slope trending

Best for: Catching institutional order flow before major moves

5. Ichimoku Cloud

Weight: 16.0 | Documentation: Ichimoku Guide

What it detects: Comprehensive trend system with dynamic support/resistance

Configuration:

ichimoku_tenkan_period: 9            # Conversion line
ichimoku_kijun_period: 26            # Base line
ichimoku_senkou_b_period: 52         # Leading span B
ichimoku_displacement: 26            # Cloud displacement
ichimoku_enable_tk_cross: true       # Enable TK cross signals
ichimoku_min_tk_separation: 0.3      # Min 0.3% TK separation
ichimoku_require_cloud_confirm: true # Require cloud confirmation

When it fires:

✅ Tenkan/Kijun bullish cross (buy) or bearish cross (sell)
✅ Price above cloud (bullish) or below cloud (bearish)
✅ Cloud color matches direction
✅ TK separation > 0.3%

Best for: Trend identification and dynamic support/resistance

Signal Types:

TK Cross: Tenkan crosses Kijun
Cloud Support: Price bounces off cloud
Cloud Breakout: Price breaks through cloud

Core Indicators (Medium-High Weights)

6. RSI Divergence

Weight: 15.0 | Documentation: RSI Divergence Guide

What it detects: Price/RSI divergence indicating momentum reversal

Configuration:

rsi_period: 14                       # RSI calculation period
rsi_divergence_lookback: 3           # Lookback for divergence
rsi_divergence_min_strength: 1.0     # Min 1% price difference

When it fires:

✅ Bullish divergence: Lower price low, higher RSI low
✅ Bearish divergence: Higher price high, lower RSI high

Best for: Catching trend reversals

7. MACD

Weight: 12.0 | Documentation: MACD Guide

What it detects: Momentum shifts and trend changes

Configuration:

macd_fast_period: 12                 # Fast EMA
macd_slow_period: 26                 # Slow EMA
macd_signal_period: 9                # Signal line
macd_histogram_strong_buy: 0.5       # Histogram threshold
macd_histogram_strong_sell: -0.5
macd_zero_line_threshold: 0.001

When it fires:

✅ MACD crosses signal line (bullish/bearish)
✅ Histogram > threshold (strong momentum)
✅ Zero line cross (trend change)

Best for: Momentum confirmation

8. RSI Extreme

Weight: 12.0 | Documentation: RSI Guide

What it detects: Overbought/oversold conditions

Configuration:

rsi_period: 14
rsi_ultra_extreme_oversold: 5.0      # RSI < 5 (ultra extreme)
rsi_extreme_oversold: 10.0           # RSI < 10 (extreme)
rsi_extreme_overbought: 90.0         # RSI > 90 (extreme)
rsi_ultra_extreme_overbought: 95.0   # RSI > 95 (ultra extreme)

When it fires:

✅ RSI enters extreme zones
✅ Higher confidence at ultra-extreme levels

Best for: Counter-trend entries at extremes

9. Bollinger Bands

Weight: 10.0 | Documentation: BB Guide

What it detects: Volatility and price extremes

Configuration:

bb_period: 20                        # Calculation period
bb_deviation: 2.0                    # Standard deviations
bb_touch_threshold: 0.001            # 0.1% from band = touch
bb_breakout_threshold: 1.01          # 1% beyond band = breakout
bb_squeeze_threshold: 0.02           # 2% bandwidth = squeeze

When it fires:

✅ Band touch (mean reversion)
✅ Band breakout (volatility expansion)
✅ Squeeze (pre-breakout setup)

Best for: Volatility-based entries

10. Volume

Weight: 10.0 | Documentation: Volume Guide

What it detects: Volume spikes and dry periods

Configuration:

volume_lookback_period: 20           # Average calculation period
volume_spike_multiplier: 2.0         # 2x average = spike
volume_dry_multiplier: 0.3           # 0.3x average = dry

When it fires:

✅ Volume spike (> 2x average)
✅ Volume dry (< 0.3x average)

Best for: Confirming breakouts

11. Momentum/Velocity

Weight: 8.0 | Documentation: Momentum Guide

What it detects: Price acceleration

Configuration:

momentum_lookback_period: 5
momentum_strong_buy: 2.0             # ≥ 2% move
momentum_strong_sell: -2.0           # ≤ -2% move
velocity_extreme_buy: 1.0            # ≥ 1% per period
velocity_extreme_sell: -1.0          # ≤ -1% per period

When it fires:

✅ Strong momentum detected
✅ Velocity acceleration

Best for: Catching explosive moves

12. ATR (Average True Range)

Weight: 5.0 | Documentation: ATR Guide

What it detects: Volatility expansion/contraction

Configuration:

atr_lookback_period: 14              # ATR average period
atr_calculation_period: 14           # ATR calculation
atr_high_volatility_multiplier: 2.0  # > 2x ATR = high volatility
atr_low_volatility_multiplier: 1.0   # < 1x ATR = low volatility

When it fires:

✅ Volatility breakout (neutral signal)
✅ Volatility compression (neutral signal)

Best for: Identifying pre-breakout conditions

Weight System

Default Signal Weights

Priority Signals (20-25 points):
├─ MTF (Multi-timeframe):        25.0
├─ CVD (Volume Delta):            22.0
├─ VWAP (Institutional Price):    20.0
├─ OFI (Order Flow):              18.0
└─ ICHIMOKU (Cloud System):       16.0

Core Signals (12-15 points):
├─ RSI_DIV (Divergence):          15.0
├─ MACD (Momentum):               12.0
├─ RSI (Extreme):                 12.0
├─ BB (Bollinger Bands):          10.0
└─ VOLUME:                        10.0

Supporting Signals (5-8 points):
├─ MOMENTUM:                       8.0
└─ ATR (Volatility):               5.0

Context-Based Weight Adjustments

The system automatically adjusts weights based on market conditions:

Trend Context

Strong Uptrend + Bullish Signal:     +20% weight
Weak Uptrend + Bullish Signal:       +10% weight
Strong Downtrend + Bullish Signal:   -30% weight
Weak Downtrend + Bullish Signal:     -15% weight

Support/Resistance Context

Bullish signal near support:         +15% weight
Bearish signal near resistance:      +15% weight

Volatility Context

Extreme volatility:                  -20% weight (all signals)
Low volatility + breakout signal:    +10% weight

Example Weight Calculation

Market Conditions:
- Trend: Strong Uptrend
- Volatility: Medium
- Price: Near support

Signal Detected: ICHIMOKU (Bullish)
Base Weight: 16.0

Adjustments:
+ Strong uptrend bonus: 16.0 × 1.20 = 19.2
+ Near support bonus: 19.2 × 1.15 = 22.08

Final Adjusted Weight: 22.08 points

Synergy Bonuses

Priority Signal Synergies (Highest Bonuses)

Triple Priority (+15.0 points)

MTF + CVD + VWAP
→ Multi-timeframe + Volume pressure + Institutional level
→ Strongest possible confluence

Order Flow Confirmation (+12.0 points)

OFI + CVD
→ Order flow imbalance + Volume delta
→ Smart money activity confirmed

Multi-Timeframe Cloud (+10.0 points)

ICHIMOKU + MTF
→ Cloud trend across multiple timeframes
→ Strong trend confirmation

Institutional Order Flow (+10.0 points)

VWAP + OFI
→ Institutional level + Order flow
→ Smart money at key levels

Volume Confirmation (+9.0 points)

CVD + VOLUME
→ Volume delta + Volume surge
→ Strong directional bias

Mixed Priority + Core Synergies

Multi-Timeframe Divergence (+9.0 points)

MTF + RSI_DIV
→ Multi-timeframe alignment + Divergence
→ Reversal across timeframes

Cloud Momentum (+8.0 points)

ICHIMOKU + MACD
→ Trend + Momentum confirmation
→ Trend continuation

Core Indicator Synergies

Divergence Momentum (+8.0 points)

RSI_DIV + MACD
→ Divergence + Momentum shift
→ Reversal confirmation

Volume Breakout (+6.0 points)

VOLUME + BB
→ Volume surge + Band breakout
→ Breakout confirmation

Extreme Bands (+5.0 points)

RSI + BB
→ Extreme levels + Band touch
→ Mean reversion setup

Multi-Signal Bonuses

Triple Priority Indicators (+12.0 points)

Any 3+ priority signals aligned
→ Rare but extremely high confidence

Triple Core Indicators (+10.0 points)

Any 3+ core signals aligned
→ Strong technical confluence

Synergy Calculation Example

Signals Detected:
1. ICHIMOKU (Bullish): +16.0
2. MACD (Bullish): +12.0
3. Volume (Bullish): +10.0

Base Total: 38.0

Synergies Detected:
- ICHIMOKU + MACD: +8.0
- (No VOLUME synergies with ICHIMOKU/MACD)

Final Weight: 38.0 + 8.0 = 46.0 points
Status: Below threshold (70.0) → No signal

Trading Setup

Step 1: Enable the System

In signalsettings.yaml:

enabled_confluence_signal: true      # Turn on Smart Confluence

Step 2: Register Signals for Auto-Trading

In tradesettings.yaml:

register_trading_signals:
  # High Priority (Recommended for auto-trading)
  - "MTF_CVD_VWAP_LONG_SIGNAL"
  - "MTF_CVD_VWAP_SHORT_SIGNAL"
  - "OFI_CVD_LONG_SIGNAL"
  - "OFI_CVD_SHORT_SIGNAL"
  - "ICHIMOKU_MTF_LONG_SIGNAL"
  - "ICHIMOKU_MTF_SHORT_SIGNAL"

  # Medium Priority (Use with caution)
  - "VWAP_OFI_LONG_SIGNAL"
  - "VWAP_OFI_SHORT_SIGNAL"
  - "ICHIMOKU_MACD_LONG_SIGNAL"
  - "ICHIMOKU_MACD_SHORT_SIGNAL"
  - "CVD_VOLUME_LONG_SIGNAL"
  - "CVD_VOLUME_SHORT_SIGNAL"

  # Lower Priority (Consider manual review)
  - "RSI_DIV_MACD_LONG_SIGNAL"
  - "RSI_DIV_MACD_SHORT_SIGNAL"
  - "MULTI_PRIORITY_LONG_SIGNAL"
  - "MULTI_PRIORITY_SHORT_SIGNAL"

Step 3: Register Signals for Notifications

In tradesettings.yaml:

register_broadcast_signals:
  # Get notified for ALL confluence signals
  - "MTF_CVD_VWAP_LONG_SIGNAL"
  - "MTF_CVD_VWAP_SHORT_SIGNAL"
  - "OFI_CVD_LONG_SIGNAL"
  - "OFI_CVD_SHORT_SIGNAL"
  - "ICHIMOKU_MTF_LONG_SIGNAL"
  - "ICHIMOKU_MTF_SHORT_SIGNAL"
  # ... add more as needed

Step 4: Tune Thresholds

Start conservative and gradually loosen:

# Week 1: Conservative (observe only)
min_weight_threshold: 80.0

# Week 2: Moderate (test with small positions)
min_weight_threshold: 70.0

# Week 3+: Optimized (based on your results)
min_weight_threshold: 65.0  # Adjust based on win rate

Best Practices

1. Threshold Tuning

For Different Market Conditions

Trending Market (strong directional moves):

min_weight_threshold: 60.0           # Lower threshold OK
mtf_min_alignment_score: 0.75        # Easier to get alignment

Ranging Market (choppy, sideways):

min_weight_threshold: 80.0           # Higher threshold required
mtf_min_alignment_score: 0.85        # Need strong alignment

Volatile Market (high ATR):

min_weight_threshold: 75.0           # Medium-high threshold
conflicting_signals_penalty: 20.0    # Increase penalty

2. Asset-Specific Tuning

High Volume Assets (BTC, ETH)

cvd_strong_buying_threshold: 1000.0
ofi_min_volume_multiplier: 1.2
volume_spike_multiplier: 2.0

Medium Volume Assets (Major Altcoins)

cvd_strong_buying_threshold: 500.0
ofi_min_volume_multiplier: 1.3
volume_spike_multiplier: 1.8

Low Volume Assets (Small Altcoins)

cvd_strong_buying_threshold: 100.0
ofi_min_volume_multiplier: 1.5
volume_spike_multiplier: 1.5

3. Risk Management by Signal Type

Signal Type	Risk Level	Position Size	Stop Loss
MTF_CVD_VWAP	Very Low	100%	-2%
OFI_CVD	Low	80-100%	-2.5%
ICHIMOKU_MTF	Low-Medium	70-90%	-3%
ICHIMOKU_MACD	Medium	50-70%	-3.5%
RSI_DIV_MACD	Medium-High	30-50%	-4%
CONFLUENCE	High	20-30%	-5%

4. Signal Filtering Strategy

Conservative Approach (Low Frequency, High Win Rate)

✅ Only trade signals with weight ≥ 75
✅ Only trade Priority Synergy patterns
✅ Require confidence ≥ 80%
✅ Avoid trading in high volatility (ATR > 2x)

Balanced Approach (Recommended)

✅ Trade signals with weight ≥ 70
✅ Trade Priority + Mixed patterns
✅ Require confidence ≥ 70%
✅ Trade in medium volatility

Aggressive Approach (High Frequency, Medium Win Rate)

✅ Trade signals with weight ≥ 60
✅ Trade all pattern types
✅ Require confidence ≥ 60%
✅ Trade in all volatility regimes

5. Monitoring and Logging

Enable comprehensive logging to understand signal decisions:

2026-01-27T04:21:50.010294Z  INFO  ✅ Collected 4 signals:
2026-01-27T04:21:50.010305Z  INFO    📌 ICHIMOKU | Bullish | Weight=16.0 | Confidence=83.5%
2026-01-27T04:21:50.010319Z  INFO    📌 MACD | Bullish | Weight=12.0 | Confidence=90.0%
2026-01-27T04:21:50.010465Z  INFO  ⚖️ Weighted Score: BUY=38.6 (+8.0) | SELL=-0.0
2026-01-27T04:21:50.010480Z  INFO    📏 BUY gap to threshold: 23.4 (need 23.4 more)
2026-01-27T04:21:50.010510Z  WARN  💡 RECOMMENDATION: BUY signal at 46.6 weight

What to monitor:

Gap to threshold (how close to triggering)
Which indicators are firing consistently
Synergy patterns that appear most often
Win rate by signal type

Troubleshooting

Problem: No Signals Generating

Symptom

⚠️ Insufficient: BUY=46.6, SELL=-0.0, Required=70.0

Solutions

1. Check Threshold

# Try lowering threshold temporarily
min_weight_threshold: 50.0           # From 70.0

2. Review Individual Indicators

Check logs for:
  ❌ MTF not detected           → MTF alignment too low
  ❌ CVD not detected           → CVD thresholds too high
  ❌ VWAP not detected          → Not at VWAP bands
  ❌ OFI not detected           → Volume too low

3. Tune Individual Thresholds

# Make signals fire more easily
mtf_min_alignment_score: 0.70        # From 0.80
cvd_strong_buying_threshold: 500.0   # From 1000.0
ofi_aggressive_buy_threshold: 60.0   # From 65.0

4. Check Data Quality

Ensure:
✅ Fetching enough candles (100+ for Ichimoku)
✅ Volume data is available
✅ MACD signal/histogram calculating (not null)

Problem: Too Many Signals (Low Quality)

Symptom

Getting signals every 5 minutes with low confidence

Solutions

1. Increase Threshold

min_weight_threshold: 80.0           # From 70.0

2. Require Higher Confidence

ichimoku_min_confidence: 65.0        # From 55.0
ofi_min_confidence: 60.0             # From 55.0
mtf_min_confidence: 75.0             # From 70.0

3. Stricter MTF Requirements

mtf_min_alignment_score: 0.85        # From 0.80
mtf_only_strong_alignment: true      # Require 80%+ alignment

4. Only Trade Priority Patterns

# In tradesettings.yaml, remove lower-priority patterns
register_trading_signals:
  - "MTF_CVD_VWAP_LONG_SIGNAL"       # Keep only these
  - "OFI_CVD_LONG_SIGNAL"            # highest quality
  - "ICHIMOKU_MTF_LONG_SIGNAL"       # signals
  # Remove: RSI_DIV_MACD, VOLUME_BB, etc.

Problem: MACD Not Contributing

Symptom

macd=null macd_signal=null macd_hist=null

Solutions

1. Verify Candle Count

max_kline_length: 60                 # Minimum for MACD
# MACD needs: 26 (slow EMA) + 9 (signal) + buffer = 50+

2. Check Logs

Look for:
INFO 🔧 ICHIMOKU_LINE_CALC: period=26, window_size=26
INFO 🔧 MACD calculation: ema12 valid, ema26 valid

3. Verify Settings

macd_fast_period: 12                 # Standard settings
macd_slow_period: 26
macd_signal_period: 9

Problem: Ichimoku Showing Weak Clouds

Symptom

⚠️ Cloud is very thin (0.10%) - signals may be less reliable
⚠️⚠️⚠️ KIJUN ≈ SENKOU_B!

Explanation

This is a legitimate market condition where recent volatility has exceeded historical volatility. The 26-period and 52-period windows contain the same highs/lows.

Solutions

1. Increase Candle Count

max_kline_length: 100                # From 60
# Provides more data for diverse price action

2. Filter Weak Clouds

ichimoku_ignore_weak_clouds: true    # Skip thin clouds
ichimoku_weak_cloud_threshold: 0.5   # Min 0.5% thickness

3. Wait for Better Conditions

Cloud will gain thickness when old extremes roll off.
Monitor cloud thickness in logs.

Problem: Volume-Based Signals Not Firing

Symptom

❌ VOLUME not detected (last=801.75, avg=834.75, ratio=0.96x)
❌ OFI: Volume confirmation failed: 0.96x vs required 1.20x

Solutions

1. Lower Volume Requirements

volume_spike_multiplier: 1.5         # From 2.0
ofi_min_volume_multiplier: 1.0       # From 1.2

2. Disable Volume Confirmation

ofi_require_volume_confirmation: false

3. Check Market Hours

Volume naturally lower during:
- Off-peak trading hours
- Weekends (crypto)
- Holidays

Consider time-based filtering or lower thresholds during these periods.

Problem: Conflicting Signals

Symptom

⚠️ Conflicting SELL: 35.0 (Penalty: -15.0%)
Final confidence reduced from 85% to 70%

Explanation

Some indicators show bullish, others bearish. System applies penalty to reduce overconfidence.

Solutions

1. Increase Conflict Penalty

conflicting_signals_penalty: 20.0    # From 15.0
conflicting_signals_threshold: 25.0  # From 30.0

2. Avoid Trading During Conflicts

Only trade when:
- One direction has >90% of weight
- Conflict weight < 20 points

3. Wait for Clarity

Conflicting signals often resolve within 1-3 candles.
Wait for stronger directional consensus.

Advanced Topics

Creating Custom Synergy Patterns

You can modify synergy detection in the code to add custom patterns:

// Add in detect_signal_synergies function

// Custom: VWAP + Volume + BB (breakout confirmation)
if has_vwap && has_volume && has_bb {
    synergies.push(SignalSynergy {
        indicators: vec!["VWAP".to_string(), "VOLUME".to_string(), "BB".to_string()],
        bonus_weight: 12.0,
        reason: "VWAP level breakout with volume confirmation".to_string(),
        pattern_id: "VWAP_VOLUME_BB".to_string(),
    });
}

Dynamic Threshold Adjustment

Automatically adjust threshold based on market conditions:

# Pseudocode concept
if volatility == "Extreme":
    min_weight_threshold = 80.0
elif volatility == "Low":
    min_weight_threshold = 60.0
else:
    min_weight_threshold = 70.0

Backtesting Recommendations

Track these metrics:

Win Rate by Signal Type
Average Win/Loss by Pattern
Optimal Threshold per Asset
Time-of-Day Performance
Volatility Regime Performance

Example tracking:

MTF_CVD_VWAP_LONG_SIGNAL:
  Trades: 15
  Win Rate: 87%
  Avg Win: +3.2%
  Avg Loss: -1.8%
  Risk/Reward: 1.78
  → Keep enabled ✅

CONFLUENCE_LONG_SIGNAL:
  Trades: 45
  Win Rate: 58%
  Avg Win: +1.5%
  Avg Loss: -2.1%
  Risk/Reward: 0.71
  → Consider disabling ❌

Recommended Configurations by Trading Style

Scalper (High Frequency)

min_weight_threshold: 50.0
mtf_min_alignment_score: 0.65
ofi_aggressive_buy_threshold: 60.0
volume_spike_multiplier: 1.3
conflicting_signals_penalty: 10.0

# Register many signal types
register_trading_signals:
  - "ICHIMOKU_MACD_LONG_SIGNAL"
  - "RSI_DIV_MACD_LONG_SIGNAL"
  - "VOLUME_BB_LONG_SIGNAL"
  - "CONFLUENCE_LONG_SIGNAL"
  # ... etc

Day Trader (Medium Frequency)

min_weight_threshold: 70.0
mtf_min_alignment_score: 0.75
ofi_aggressive_buy_threshold: 65.0
volume_spike_multiplier: 1.8
conflicting_signals_penalty: 15.0

# Register high-quality signals
register_trading_signals:
  - "MTF_CVD_VWAP_LONG_SIGNAL"
  - "OFI_CVD_LONG_SIGNAL"
  - "ICHIMOKU_MTF_LONG_SIGNAL"
  - "ICHIMOKU_MACD_LONG_SIGNAL"

Swing Trader (Low Frequency)

min_weight_threshold: 80.0
mtf_min_alignment_score: 0.85
ofi_aggressive_buy_threshold: 70.0
volume_spike_multiplier: 2.0
conflicting_signals_penalty: 20.0

# Only highest quality
register_trading_signals:
  - "MTF_CVD_VWAP_LONG_SIGNAL"
  - "OFI_CVD_LONG_SIGNAL"
  - "MULTI_PRIORITY_LONG_SIGNAL"

Quick Reference

Signal Quality Ranking

Tier 1 (Highest Quality)

MTF_CVD_VWAP (82 pts, 85-95% conf)
OFI_CVD (52 pts, 80-90% conf)
ICHIMOKU_MTF (51 pts, 75-85% conf)

Tier 2 (High Quality)

VWAP_OFI (48 pts, 75-85% conf)
MTF_RSI_DIV (49 pts, 75-85% conf)
CVD_VOLUME (41 pts, 70-80% conf)

Tier 3 (Good Quality)

ICHIMOKU_MACD (36 pts, 70-80% conf)
RSI_DIV_MACD (35 pts, 70-80% conf)
MULTI_PRIORITY (variable, 80-90% conf)

Tier 4 (Acceptable)

VOLUME_BB (26 pts, 65-75% conf)
RSI_BB (27 pts, 65-75% conf)
CONFLUENCE (70 pts, 60-70% conf)

Common Weight Combinations

To reach 70.0 threshold, you need combinations like:

Priority Heavy:
  MTF (25) + CVD (22) + VWAP (20) + synergy (15) = 82 ✅

Mixed Approach:
  ICHIMOKU (16) + MACD (12) + RSI_DIV (15) + VWAP (20) + synergies = 71 ✅

Core Heavy:
  RSI_DIV (15) + MACD (12) + RSI (12) + BB (10) + VOLUME (10) + synergies = 67 ❌
  (Need one more indicator or stronger synergies)

Default Thresholds Cheat Sheet

# Signal Generation
min_weight_threshold: 70.0           # 50-80 range

# MTF
mtf_min_alignment_score: 0.80        # 0.6-0.9 range
mtf_min_trend_strength: 2.0          # 1.0-3.0 range

# CVD  
cvd_strong_buying_threshold: 1000.0  # Asset-specific

# VWAP
vwap_band_penetration_threshold: 0.5 # 0.3-1.0 range

# OFI
ofi_aggressive_buy_threshold: 65.0   # 60-75 range
ofi_min_volume_multiplier: 1.2       # 1.0-1.5 range

# Ichimoku
ichimoku_min_tk_separation: 0.3      # 0.2-0.5 range
ichimoku_min_confidence: 55.0        # 50-70 range

# MACD
macd_histogram_strong_buy: 0.5       # 0.3-1.0 range

# RSI
rsi_extreme_oversold: 10.0           # 5-20 range
rsi_extreme_overbought: 90.0         # 80-95 range

# BB
bb_squeeze_threshold: 0.02           # 0.015-0.025 range

# Volume
volume_spike_multiplier: 2.0         # 1.5-3.0 range

# ATR
atr_high_volatility_multiplier: 2.0  # 1.5-3.0 range

Support and Resources

Documentation Links

Getting Started Checklist

[ ] Enable Smart Confluence in signalsettings.yaml
[ ] Set threshold (start at 70.0)
[ ] Configure asset-specific thresholds (CVD, volume)
[ ] Register desired signals in tradesettings.yaml
[ ] Enable broadcast notifications
[ ] Monitor logs for 1-2 days without trading
[ ] Tune thresholds based on signal frequency
[ ] Start with small position sizes
[ ] Track performance by signal type
[ ] Adjust configuration based on results

Key Takeaways

✅ Quality over quantity - Wait for strong confluence
✅ Start conservative - Use high threshold (70-80) initially
✅ Monitor closely - Check logs to understand decisions
✅ Tune gradually - Adjust based on actual performance
✅ Trust the system - Designed to filter false signals
✅ Risk management - Always use stop losses
✅ Asset-specific - Tune for each trading pair
✅ Market-aware - Adjust for volatility regimes

Last Updated: January 27, 2026
Version: 1.0
System: Smart Confluence Signal v4.0

Smart Confluence Signal - Complete User Guide

Table of Contents

Overview

Key Features

Philosophy

How It Works

3-Step Process

Step 1: Individual Signal Detection

Step 2: Weight Calculation

Step 3: Synergy Detection

Step 4: Threshold Check

Example Calculation

Signal Types & Patterns

Priority Synergy Patterns (Highest Quality)

🏆 MTF_CVD_VWAP (Long/Short)

🏆 OFI_CVD (Long/Short)

🏆 ICHIMOKU_MTF (Long/Short)

🏆 VWAP_OFI (Long/Short)

🏆 CVD_VOLUME (Long/Short)

Mixed Priority + Core Patterns

📊 MTF_RSI_DIV (Long/Short)

📊 ICHIMOKU_MACD (Long/Short)

Core Indicator Patterns

📈 RSI_DIV_MACD (Long/Short)

📈 VOLUME_BB (Long/Short)

📈 RSI_BB (Long/Short)

Multi-Signal Confirmations

🎯 MULTI_PRIORITY (Long/Short)

🎯 MULTI_CORE (Long/Short)

Fallback Pattern

⚪ CONFLUENCE (Long/Short)

Configuration Guide

Quick Start Configuration

Conservative (Low Risk, Fewer Trades)

Balanced (Recommended)

Aggressive (Higher Risk, More Trades)

Essential Settings

Master Switch

Threshold Control

Conflict Handling

Indicator Details

Priority Indicators (Highest Weights)

1. Multi-Timeframe Alignment (MTF)

2. Cumulative Volume Delta (CVD)

3. VWAP Bands

4. Order Flow Imbalance (OFI)

5. Ichimoku Cloud

Core Indicators (Medium-High Weights)

6. RSI Divergence

7. MACD

8. RSI Extreme

9. Bollinger Bands

10. Volume

11. Momentum/Velocity

12. ATR (Average True Range)

Weight System

Default Signal Weights

Context-Based Weight Adjustments

Trend Context

Support/Resistance Context

Volatility Context

Example Weight Calculation

Synergy Bonuses

Priority Signal Synergies (Highest Bonuses)

Triple Priority (+15.0 points)

Order Flow Confirmation (+12.0 points)

Multi-Timeframe Cloud (+10.0 points)

Institutional Order Flow (+10.0 points)

Volume Confirmation (+9.0 points)

Mixed Priority + Core Synergies

Multi-Timeframe Divergence (+9.0 points)

Cloud Momentum (+8.0 points)

Core Indicator Synergies

Divergence Momentum (+8.0 points)

Volume Breakout (+6.0 points)

Extreme Bands (+5.0 points)

Multi-Signal Bonuses

Triple Priority Indicators (+12.0 points)

Triple Core Indicators (+10.0 points)

Synergy Calculation Example