What problem does it solve?
It helps analysts automatically find XABCD harmonic chart structures and convert them into actionable long/short signals near the PRZ reversal zone, reducing manual pattern scanning effort.
Core Features & Use Cases
- Harmonic pattern identification: Detects Gartley, Bat, Butterfly, and Crab patterns using Fibonacci geometry over X-A-B-C-D swings.
- PRZ-focused signaling: Emits signals specifically at the D point (potential reversal zone) using a bullish/bearish convention (bullish D bottom → long; bearish D top → short).
- Two detection backends: Prefers pyharmonics for richer detection, with a built-in fallback swing-combination detector when pyharmonics is unavailable.
- Use Case: Scan BTC/ETH/SOL OHLCV data to find recurring harmonic PRZ setups and generate a per-timestamp signal series for backtesting or strategy prototypes.
Quick Start
Run the harmonic-patterns signal engine on your OHLCV DataFrame(s) and return a signal series where 1 indicates long, -1 indicates short, and 0 indicates stand aside.