ICT Turtle Soup

ICT Turtle Soup identifies classic “failed breakout” reversals after liquidity sweeps of recent highs/lows, then augments the setup with volume validation, market structure context, Kill Zone (session) filters, Order Blocks (OB), Fair Value Gaps (FVG), OTE (61.8–78.6%) zones, and optional risk targets (SL/TP 1:1, 1:2, 1:3). A compact dashboard summarizes current context (recent high/low, lookbacks, active session, structure state, mitigation counts).

What the Script Does
⦁ Detects Turtle Soup events: Price breaks a prior swing extreme and then quickly reverses back inside the range.
⦁ Grades signal quality: Factors include reversal speed, volume confirmation, breakout magnitude, and consecutive patterns.
⦁ Overlays market context: Trend/range classification (ADX / MA / ATR Bands / Combined), Kill Zones (Asian/London/NY), and time-of-day filters.
⦁ Marks IMB / mitigation zones: Draws Order Blocks and Fair Value Gaps, with optional live mitigation tracking and fading/removal on mitigation.
⦁ Shows OTE zones (61.8–78.6%) after confirmed reversals to highlight potential pullback entries.
⦁ Plots risk management guides: Optional SL buffer below/above reversal wick and TP bands at 1:1, 1:2, 1:3 R multiples.
⦁ Emits alerts on bullish/bearish Turtle Soup confirmations.

How It Works (Conceptual)

1. Liquidity Sweep & Breakout Check
⦁ Looks back over user-defined windows (single or multiple lookbacks: short/medium/long) to find the most recent swing high/low.
⦁ Flags a breakout when price pierces that swing (above for bearish, below for bullish).
⦁ Optional breakout bar volume check requires volume > avg(volume, N) × multiplier.
⦁ Optional swing age check requires the broken swing to be at least X bars old.

2. Reversal Confirmation
⦁ Within N bars after the sweep, validates a mean-reversion close back inside the prior range with a minimum wick/body ratio to confirm rejection.
⦁ Quality Score adds points for:
⦁ Speed: reversal within fast_reversal_bars;
⦁ Volume: breakout and/or reversal volume spike;
⦁ Series: previous consecutive signals;
⦁ Magnitude: sufficient sweep distance.
⦁ Optional high-quality filter only shows signals meeting a minimum score.

3. Context Filters (Optional)
⦁ Sessions/Kill Zones: Only allow signals in selected sessions (Asian/London/NY) with fully custom HHMM inputs.
⦁ Time Window: Restrict to specific hours (e.g., 08–12).
⦁ Market Structure: Classify Trending vs. Ranging (via ADX, MA separation/slope, ATR bands, or Combined). You can allow signals in trends, ranges, or both.

4. Smart Confluence Layers
⦁ Order Blocks: Finds likely OBs with structural validation (e.g., bearish up-candle prior to down move), imbalance score (body/range × volume factor), and extend-until-touched with mitigation % tracking.
⦁ Fair Value Gaps: Detects valid 3-bar gaps (bull/bear) with size threshold, supports touch / 50% / full mitigation logic, and can fade or remove after mitigation.
⦁ OTE Zones: After a reversal, projects the 61.8–78.6% retracement box from the actual swing range; offset scales to timeframe to avoid clutter.

5. Risk & Display
⦁ SL/TP guides: Optional wick-buffered SL and 1:1/1:2/1:3 TPs.
⦁ Dashboard: Recent high/low, active lookbacks, current session, structure label, and live counts of mitigated OBs/FVGs.

Signals & Visuals
⦁ Bullish Turtle Soup: Triangle up + label (🐢S/M/L/D + star rating).
⦁ Bearish Turtle Soup: Triangle down + label (🐢S/M/L/D + star rating).
⦁ Labels can show: quality stars, FAST/SLOW reversal, reversal & breakout volume tags, previous consecutive count, and last move %.
⦁ Lines/Boxes: OBs, FVGs, OTE zones, SL/TP bands, and optional breakout magnitude line.

Inputs (Key Groups)
⦁ Turtle Soup: Lookbacks (single or S/M/L), reversal bars, wick ratio, magnitude line, reversal speed, volume confirmation (multiplier/length), consecutive tracking.
⦁ Order Blocks: Show/validate structure, lookback, extend-until-touched, mitigation % threshold, colors.
⦁ Fair Value Gaps: Show, min size %, colors, mitigation mode (Touch/50%/Full), optional remove-on-mitigation.
⦁ Kill Zones/Sessions: Enable Asian/London/NY with custom HHMM, colors.
⦁ OTE: Show OTE (61.8–78.6%), color, timeframe-adaptive offsets.
⦁ Signal Filters: Filter by session, time window, market structure method (ADX/MA/ATR/Combined), thresholds (ADX, MA periods, ATR multiplier), trending/ranging allowances, structure label & offset.
⦁ SL/TP: SL buffer %, TP 1:1/1:2/1:3 toggles & colors.
⦁ Breakout Validation: Require breakout-bar volume, min swing age, volume label toggles.
⦁ Alerts: Enable/disable.
⦁ Dashboard: Position, text size, colors, border.

How to Use
1. Markets & Timeframes: Works on FX, crypto, indices, and futures. Start with M5–H1 for intraday and H1–H4 for swing; refine lookbacks per instrument volatility.

2. Core Flow:
⦁ Enable multiple lookbacks for robustness on mixed volatility.
⦁ Turn on validate_swing_significance to avoid micro sweeps.
⦁ Use validate_breakout_volume + use_volume_confirmation to filter weak pokes.

3. Context Choice:
⦁ In ranging environments, allow both sides; in trends, consider counter-trend only at HTF OB/FVG/OTE confluence.
⦁ Narrow to London/NY for higher activity if desired.

4. Entries/Stops/Targets:
⦁ Entry on confirmed label close or at OTE pullback post-signal.
⦁ SL: below/above reversal wick + sl_buffer%.
⦁ TP: scale at 1:1/1:2/1:3 or manage via OB/FVG/structure breaks.

5. Confluence: Prefer Turtle Soup that aligns with OB/FVG zones and Combined structure method for added reliability.

Alerts
⦁ “Bullish Turtle Soup detected” and “Bearish Turtle Soup detected” fire on confirmation.
⦁ Set to Once Per Bar (as coded) or adjust in the alert dialog per your workflow.

Notes & Tips
⦁ Multiple lookbacks (S/M/L) help capture both shallow and deep liquidity sweeps.
⦁ Use market structure label with offset to keep it readable on the right of price.
⦁ Mitigation tracking visually communicates when OB/FVG confluence is no longer valid.
⦁ Dashboard = fast situational awareness; keep it on during live trading.

Limitations & Disclaimer
⦁ This tool is educational and not financial advice. No profitability or win-rate is implied. Markets carry risk; manage position size and test thoroughly.
⦁ Signal quality depends on market regime, spreads, news, and data quality. Backtests/forward-tests may differ.
⦁ Visual objects are capped for performance; old items may auto-clean to keep charts responsive.