# Hull Suite

Based on the Hull Moving Average by Alan Hull. Combines HMA with ATR-based bands
to define a breakout zone, trading only when price escapes the band with the HMA
confirming the trend direction.

## Versions

| Version | File    | Notes                                      |
|---------|---------|--------------------------------------------|
| v2      | v2.json | HMA(9) + ATR(14) bands, slope confirmation |

## Logic

**HMA(9)** = `WMA(2 × WMA(close, 4) − WMA(close, 9), 3)` — `floor(sqrt(9)) = 3`
**Upper band**: HMA(9) + ATR(14)
**Lower band**: HMA(9) − ATR(14)

**Entry**: close > upper band AND HMA rising (HMA > HMA[1]).
**Exit**: close < lower band OR HMA declining (HMA < HMA[1]).

## Indicators

- `WMA(4)`, `WMA(9)` — weighted moving averages
- `apply_func(wma, period=3)` — outer WMA for HMA calculation
- `ATR(14)` — band width

## Data requirements

- 1h candles recommended.
- Minimum warmup: ~20 candles for WMA/ATR components.

## Known limitations

- HMA(9) is a short-period indicator; it reacts quickly to price changes but
  generates more false signals in low-volatility periods.
- ATR bands are fixed multiplier (×1); some implementations use ×1.5 or ×2 for
  wider bands and fewer false breakouts.
