Breakout Structure Signals

Breakout Structure Signals
Trend-following Donchian breakouts with optional retests, HTF trend filter, volume & ADX gates, and one-signal-per-direction control.
What it does

• Prints LONG/SHORT when price breaks the prior Donchian High/Low and/or makes a qualified retest of that level.
  
• Works with trend via EMAs on the chart TF; optional HTF EMA filter confirms higher-timeframe bias.
  
• Optional Volume and ADX filters, plus soft candle-quality checks.
  
• Signals confirm on bar close (no intrabar repaint on your chart TF). Duplicate signals can be suppressed until direction flips.
  

Core logic

• Breakout Long:close > DonchianHigh[1] AND EMAfast > EMAslow AND close > EMAslow.
  
• Breakout Short:close < DonchianLow[1] AND EMAfast < EMAslow AND close < EMAslow.
  
• Retest (optional): after breakout, wait up to maxBarsWait for a pullback within ATR × retestTolATR around the breakout level; price must also align with the fast EMA (above for longs, below for shorts).
  
• Filters (optional): Volume > SMA20 × volMult, ADX > 20, candle-quality: close position within range ≥ closePosMin and body/range ≥ impulseBodyMin.
  
• HTF trend (optional): Longs require HTF EMAfast > HTF EMAslow; shorts require the opposite (via request.security on htf_tf).
  

Inputs (key)

• lengthRange — Donchian N (high/low lookback).
  
• emaFastLen, emaSlowLen — chart-TF trend filter.
  
• useVolumeFilt, volMult — volume gate (turn OFF where volume is unreliable).
  
• useRetest, retestTolATR, maxBarsWait — retest behavior & tolerance.
  
• useADX, adxLen — trend-strength filter.
  
• useHTF, htf_tf, htfEmaFastLen, htfEmaSlowLen — higher-TF confirmation.
  
• useCandleQual, closePosMin, impulseBodyMin — soft candle-quality checks.
  
• confirmOnClose — confirm signals on close.
  
• suppressSameSide — block repeats until reversal.
  
• showBg — background highlight on signal bars.
  

Visuals

• Plots: EMA Fast, EMA Slow, Donchian High/Low.
  
• Markers: triangle LONG below bars, triangle SHORT above bars.
  
• Optional background tint on signal bars.
  

Alerts

• LONG signal — breakout or qualified retest (long).
  
• SHORT signal — breakout or qualified retest (short).
  

How to use

• Start with Donchian 20, EMA 20/50; for LTF trading, consider HTF = 60m/240m.
  
• Retests: try 0.3–0.6 ATR tolerance and 8–12 bars wait for cleaner fills.
  
• Stops: beyond breakout/retest by 1–1.5 ATR or beyond fast EMA; manage with partials and a trailing exit.
  
• Turn Volume filter OFF where volume isn’t informative.
  

This indicator provides signals only; always combine with risk management.