What problem does it solve?
Candlestick pattern recognition engine that identifies 15 classic patterns (5 single-candle, 5 double-candle, 4 triple-candle, plus a trend confirmation) and generates a composite trading signal from bullish/bearish scores, enabling systematic decision making without manual pattern scanning.
Core Features & Use Cases
- Pattern coverage: detects 15 classic candlestick formations across single, double, and triple candles, plus a trend check.
- Vectorized implementation: pure pandas-based, designed for fast and scalable computation on large OHLCV datasets.
- Unified signal output: combines individual pattern scores into a single per-timestamp signal (1 for bullish, -1 for bearish, 0 for neutral).
- Configurable sensitivity: exposes body_pct and shadow_ratio to tune for doji sensitivity and shadow length.
- Use cases: backtest candlestick-based strategies, generate live signals, or build rule-based entry/exit systems.
Quick Start
Provide an OHLCV dataframe to the engine and obtain a per-row signal representing the aggregated candlestick pattern scores.