technical-basic

# Core Technical Indicator Collection ## Purpose Combines three classic Western technical analysis approaches into one composite signal engine: | Dimension | Indicators | Purpose | |------|------|------| | Trend | EMA(12/26) + ADX(14) | Determine direction and trend strength | | Mean reversion | Bollinger Bands(20,2) + RSI(14) | Detect overbought and oversold conditions | | Volume-price | OBV + volume ratio | Confirm volume participation | ## Signal Logic Three-dimensional voting mechanism: - **Long**: trend is bullish + RSI is not overbought + OBV is rising - **Short**: trend is bearish + RSI is not oversold + OBV is falling - **Stand aside**: mixed signals ## Key Implementation Details - RSI and ADX use **Wilder EWM** (`ewm(alpha=1/period)`), not a rolling mean - Full ADX chain: +DM/-DM → TR → +DI/-DI → DX → ADX - OBV = `(volume * sign(close.diff())).cumsum()` ## Parameters All parameters have default values and can be overridden at instantiation time: | Parameter | Default | Description | |------|--------|------| | ema_fast | 12 | Fast EMA period | | ema_slow | 26 | Slow EMA period | | adx_period | 14 | ADX calculation period | | adx_threshold | 25.0 | ADX trend-strength threshold | | bb_window | 20 | Bollinger Band window | | bb_std | 2.0 | Bollinger Band standard deviation multiplier | | rsi_period | 14 | RSI period | | rsi_oversold | 30 | RSI oversold threshold | | rsi_overbought | 70 | RSI overbought threshold | | vol_ma_period | 20 | Volume moving-average period | | obv_ma_period | 20 | OBV moving-average period | ## Dependencies ```bash pip install pandas numpy requests ``` ## Signal Convention - `1` = long, `-1` = short, `0` = stand aside