SMC Suite – OB • Breaker • Liquidity Sweep • FVG

SMC Suite — Order Blocks • Breaker • Liquidity Sweep • FVG

What it does:
Maps institutional SMC structure (OB → Breaker flips, Liquidity Sweeps, and 3-bar FVGs) and alerts when price retests those zones with optional rejection-wick confirmation.


Why this isn’t “just a mashup”?

This tool implements a specific interaction between four classic SMC concepts instead of only plotting them side-by-side:
1. OB → Breaker Flip (automated): When price invalidates an Order Block (OB), the script converts that zone into a Breaker of opposite bias (bullish ⇄ bearish), extends it, and uses it for retest signals.
2. Liquidity-Gated FVGs: Fair Value Gaps (3-bar imbalances) are optionally gated—they’re only drawn/used if a recent liquidity sweep occurred within a user-defined lookback.
3. Retest Engine with Rejection Filter: Entries are not whenever a zone prints. Signals fire only if price retests the zone, and (optionally) the candle shows a rejection wick ≥ X% of its range.
4. Signal Cooldown: Prevents spam by enforcing a minimum bar gap between consecutive signals.

These behaviors work together to catch the sequence many traders look for: sweep → impulse → OB/FVG → retest + rejection.

Concepts & exact rules

1) Impulsive move and swing structure
• A bar is “impulsive” when its range ≥ ATR × Impulsive Mult and it closes in the direction of the move.
• Swings use Pivot Length (lenSwing) on both sides (HH/LL detection). These HH/LLs are also used for sweep checks.

2) Order Blocks (OB)
• Bullish OB: last bearish candle body before an impulsive up-move that breaks the prior swing high. Zone = min(open, close) to low of that candle.
• Bearish OB: last bullish candle body before an impulsive down-move that breaks the prior swing low. Zone = high to max(open, close).
• Zones extend right for OB Forward Extend bars.

3) Breaker Blocks (automatic flip)

If price invalidates an OB (closes below a bullish OB’s low or above a bearish OB’s high), that OB flips into a Breaker of opposite bias:
• Invalidated bullish OB → Bearish Breaker (resistance).
• Invalidated bearish OB → Bullish Breaker (support).
Breakers get their own style/opacity and are used for separate Breaker Retest signals.

4) Liquidity Sweeps (decluttered)
• Bullish sweep: price takes prior high but closes back below it.
• Bearish sweep: price takes prior low but closes back above it.
Display can be tiny arrows (default), short non-extending lines, or hidden. Old marks auto-expire to keep the chart clean.

5) Fair Value Gaps (FVG, 3-bar)
• Bearish FVG: high[1] < low[2] and current high < low[2].
• Bullish FVG: low[1] > high[2] and current low > high[2].
• Optional gating: only create/use FVGs if a sweep occurred within ‘Recent sweep’ lookback.

6) Retest signals (what actually alerts)

A signal is true when price re-enters a zone and (optionally) the candle shows a rejection wick:
• OB Retest LONG/SHORT — same-direction retest of OB.
• Breaker LONG/SHORT — opposite-direction retest of flipped breaker.
• FVG LONG/SHORT — touch/fill of FVG with rejection.
You can require a wick ratio (e.g., bottom wick ≥ 60% of range for longs; top wick for shorts). A cooldown prevents back-to-back alerts.

How to use
1. Pick timeframe/market: Works on any symbol/TF. Many use 15m–4h intraday and 1D swing.
2. *Tune Pivot Length & Impulsive Mult:
• Smaller = more zones and quicker flips; larger = fewer but stronger.
3. Decide whether to gate FVGs with sweeps: Turn on “Require prior Liquidity Sweep” to focus on post-liquidity setups.
4. Set wick filter: Start with 0.6 (60%) for cleaner signals; lower it if too strict.
5. Style: Use the Style / Zones & Style / Breakers groups to set colors & opacity for OB, Breakers, FVGs.
6. Alerts: Add alerts on any of:
• OB Retest LONG/SHORT
• Breaker LONG/SHORT
• FVG LONG/SHORT
Choose “Once per bar close” to avoid intrabar noise.

Inputs (key)
• Swing Pivot Length — swing sensitivity for HH/LL and sweeps.
• Impulsive Move (ATR ×) — defines the impulse that validates OBs.
• OB/FVG Forward Extend — how long zones project.
• Require prior Liquidity Sweep — gate FVG creation/usage.
• Rejection Wick ≥ % — confirmation filter for retests.
• Signal Cooldown (bars) — throttles repeated alerts.
• Display options for sweep marks — arrows vs short lines vs hidden.
• Full color/opacity controls — independent palettes for OB, Breakers, and FVGs (fills & borders).

What’s original here
• Automatic OB → Breaker conversion with separate retest logic.
• Liquidity-conditioned FVGs (FVGs can be required to follow a recent sweep).
• Unified retest engine with wick-ratio confirmation + cooldown.
• Decluttered liquidity visualization (caps, expiry, and non-extending lines).
• Complete styling controls for zone types (fills & borders), plus matching signal label colors.

🔹 Notes
• This script is invite-only.
• It is designed for educational and discretionary trading use, not as an autotrader.
• No performance guarantees are implied — always test on multiple markets and timeframes.