| name | harmonic |
| description | Harmonic Patterns signal engine. Identifies XABCD five-point structures such as Gartley/Bat/Butterfly/Crab based on Fibonacci geometry, and generates trading signals in the PRZ (Potential Reversal Zone). |
| category | strategy |
Harmonic Patterns
Purpose
The Fibonacci geometry school uses precise ratio relationships to identify price patterns:
| Pattern | B-Point Retracement | D-Point Retracement | Direction |
|---|
| Gartley | 0.618 XA | 0.786 XA | Reversal |
| Bat | 0.382-0.5 XA | 0.886 XA | Reversal |
| Butterfly | 0.786 XA | 1.27 XA | Reversal |
| Crab | 0.382-0.618 XA | 1.618 XA | Reversal |
Core Concepts
- XABCD five-point pattern: a price structure defined by precise Fibonacci ratios
- PRZ (Potential Reversal Zone): the convergence area around point D, where reversal probability is high
- Bullish pattern (point D at the bottom) → buy signal
- Bearish pattern (point D at the top) → sell signal
Dependencies
pip install "vibe-trading-ai[harmonic]"
pyharmonics is optional. If the extra is not installed, the example signal
engine falls back to the bundled detector.
Parameters
| Parameter | Default | Description |
|---|
| is_stock | False | Whether the instrument is a stock (affects analysis parameters) |
Signal Convention
1 = long, -1 = short, 0 = stand aside
