Add momentum confluence

Author: MDUYN

README.md

@@ -36,6 +36,7 @@ pip install pyindicators
   * [Williams %R](#williams-r)
   * [Average Directional Index (ADX)](#average-directional-index-adx)
   * [Stochastic Oscillator (STO)](#stochastic-oscillator-sto)
+  * [Momentum Confluence](#momentum-confluence)
 * [Volatility indicators](#volatility-indicators)
   * [Bollinger Bands (BB)](#bollinger-bands-bb)
   * [Bollinger Bands Overshoot](#bollinger-bands-overshoot)
@@ -541,6 +542,78 @@ pd_df.tail(10)
 
 ![STO](https://github.com/coding-kitties/PyIndicators/blob/main/static/images/indicators/sto.png)
 
+#### Momentum Confluence
+
+Momentum Confluence is a comprehensive multi-component oscillator that combines multiple technical analysis components to provide a powerful trend following and reversal detection system.
+
+**Components:**
+1. **Money Flow**: Measures buying/selling liquidity entering the market (-100 to +100)
+2. **Thresholds**: Dynamic levels showing significant buying/selling activity
+3. **Overflow**: Detects excess buying/selling that predicts reversals
+4. **Trend Wave**: A highly reactive trend-following oscillator (0-100)
+5. **Real-Time Divergences**: Price vs oscillator divergence detection
+6. **Reversal Signals**: High-frequency (small dots) and strong (arrows) reversal signals
+7. **Confluence**: Combined signal strength from all components (-100 to +100)
+
+```python
+def momentum_confluence(
+    data: Union[PdDataFrame, PlDataFrame],
+    money_flow_length: int = 14,
+    trend_wave_length: int = 10,
+    threshold_mult: float = 1.5,
+    overflow_threshold: float = 0.8,
+    divergence_lookback: int = 5,
+    high_column: str = 'High',
+    low_column: str = 'Low',
+    close_column: str = 'Close',
+    volume_column: str = 'Volume',
+    ...
+) -> Union[PdDataFrame, PlDataFrame]:
+```
+
+Example
+
+```python
+from pyindicators import (
+    momentum_confluence,
+    momentum_confluence_signal,
+    get_momentum_confluence_stats
+)
+
+# Calculate Momentum Confluence
+df = momentum_confluence(df)
+
+# Generate trading signals
+df = momentum_confluence_signal(df)
+
+# Get statistics
+stats = get_momentum_confluence_stats(df)
+print(f"Strong bullish reversals: {stats['strong_reversal_bullish_count']}")
+print(f"Divergences detected: {stats['divergence_bullish_count']}")
+```
+
+**Output Columns:**
+- `money_flow`: Money flow oscillator (-100 to +100)
+- `mf_upper_threshold` / `mf_lower_threshold`: Dynamic threshold levels
+- `overflow_bullish` / `overflow_bearish`: Excess buying/selling (0 or 1)
+- `trend_wave`: Trend oscillator (0-100)
+- `trend_wave_signal`: Trend direction (1=bullish, -1=bearish, 0=neutral)
+- `divergence_bullish` / `divergence_bearish`: Divergence detection (0 or 1)
+- `reversal_bullish` / `reversal_bearish`: High-frequency reversal signals (0 or 1)
+- `reversal_strong_bullish` / `reversal_strong_bearish`: Strong reversal signals (0 or 1)
+- `confluence`: Combined signal strength (-100 to +100)
+- `mc_trend`: Overall trend direction (1=bullish, -1=bearish, 0=neutral)
+
+**Signal Values (from momentum_confluence_signal):**
+- `2`: Strong bullish reversal signal
+- `1`: Bullish confluence
+- `0`: Neutral
+- `-1`: Bearish confluence
+- `-2`: Strong bearish reversal signal
+
+![MOMENTUM_CONFLUENCE](https://github.com/coding-kitties/PyIndicators/blob/main/static/images/indicators/momentum_confluence.png)
+
+
 ### Volatility indicators
 
 Indicators that measure the rate of price movement, regardless of direction. They help to identify

pyindicators/__init__.py

@@ -16,7 +16,9 @@
     order_blocks, ob_signal, get_active_order_blocks,
     market_structure_break, market_structure_ob,
     msb_signal, ob_quality_signal, get_market_structure_stats,
-    market_structure_choch_bos, choch_bos_signal, get_choch_bos_stats
+    market_structure_choch_bos, choch_bos_signal, get_choch_bos_stats,
+    momentum_confluence, momentum_confluence_signal,
+    get_momentum_confluence_stats
 )
 from .exceptions import PyIndicatorException
 from .date_range import DateRange
@@ -96,5 +98,8 @@ def get_version():
     'get_market_structure_stats',
     'market_structure_choch_bos',
     'choch_bos_signal',
-    'get_choch_bos_stats'
+    'get_choch_bos_stats',
+    'momentum_confluence',
+    'momentum_confluence_signal',
+    'get_momentum_confluence_stats'
 ]

pyindicators/indicators/__init__.py

@@ -36,6 +36,10 @@
     msb_signal, ob_quality_signal, get_market_structure_stats,
     market_structure_choch_bos, choch_bos_signal, get_choch_bos_stats
 )
+from .momentum_confluence import (
+    momentum_confluence, momentum_confluence_signal,
+    get_momentum_confluence_stats
+)
 
 __all__ = [
     'sma',
@@ -97,5 +101,8 @@
     'get_market_structure_stats',
     'market_structure_choch_bos',
     'choch_bos_signal',
-    'get_choch_bos_stats'
+    'get_choch_bos_stats',
+    'momentum_confluence',
+    'momentum_confluence_signal',
+    'get_momentum_confluence_stats'
 ]