harmonic-patterns

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.