SM OB Intraday Bot Assistant

SM OB Intraday Bot Assistant is an intraday tool built around Smart Money Concepts (SMC). It focuses on market structure, Order Blocks and mitigation, and then turns them into a complete trade plan with entry, adaptive stop-loss and structured take-profit levels.

────────────────────
1. Concept & purpose
────────────────────
The script is designed for intraday trading on 15m–1h timeframes. It automates a classic SMC workflow:

1) Detect swing structure and Break Of Structure (BOS).
2) Identify bullish/bearish Order Blocks (OB) and Hidden Order Blocks (HOB).
3) Filter them using impulse strength, volume and Fib/OTE confluence.
4) Build a trade idea: Entry, Stop-Loss, TP1, TP2, TP3.
5) Track trade status and basic statistics on chart.

The source is protected (invite-only), but the logic below describes how the script works so traders can understand and use it.

────────────────────
2. Structure, BOS and FVG
────────────────────
• Swings are detected using configurable swing length.
• BOS is confirmed only when:
– Price closes beyond the last swing high/low by a minimum tick distance.
– The break candle is an impulse: its body must exceed a minimum ATR fraction and a minimum Body/Range ratio.
• Optional filter: the BOS candle must also create a 3-bar Fair Value Gap (FVG).
This helps the script focus on meaningful breaks instead of random noise.

────────────────────
3. Order Blocks & Hidden OBs
────────────────────
After a valid BOS, the script looks back for the last opposite candle to define an Order Block:

• Only small-body candles are considered (body ≤ X% of total range), with a minimum OB height in ticks.
• OBs can be built using either candle bodies or full wicks.
• Hidden OBs (HOBs) are marked when price creates same-bias FVGs further in the direction of the BOS, while the original OB remains unmitigated.
• Each OB is stored as a box that can be:
– Extended to the right,
– Limited to N bars, or
– Kept only at its origin.

Mitigation state is tracked for each OB:
• 0 = untouched
• 1 = partially mitigated
• 2 = fully mitigated

The user can choose which mitigation states to display.

────────────────────
4. Fib / OTE confluence
────────────────────
The script automatically builds the last significant leg between swing low and swing high and computes:

• Fib levels 0.618 / 0.705 / 0.786
• An OTE band (roughly between the 62–79% retracement area)

An OB is marked as “in confluence” when its midpoint is near these Fib levels or inside the OTE band, with tolerance based on ATR. This allows traders to focus on OBs that align with both structure and retracement logic.

────────────────────
5. Volume filter
────────────────────
For each OB, the script compares its candle volume to a volume moving average:

• If enabled, only OBs with volume ≥ (multiplier × volume MA) are considered valid for entries.
This acts as a simple high-volume filter to ignore weak zones that form on low participation.

────────────────────
6. Trade logic and “smart” levels
────────────────────
When a new qualified OB appears and meets the filters, the script builds a full intraday trade plan:

• Entry:
– Taken from the midpoint of the OB (PIN / mid-zone), not from an arbitrary price.

• Stop-Loss:
– For longs: behind the nearest meaningful low (recent swing low or OB low).
– For shorts: behind the nearest meaningful high (recent swing high or OB high).
– The SL is then capped so that its distance never exceeds the distance to TP1.
This keeps risk under control and avoids oversized stops.

• Take Profits (TP1, TP2, TP3):
– Targets are not fixed percentages of stop.
– The script computes a “base unit” using:
• distance to the next structure level,
• ATR,
• OB height,
• and a minimum percentage of price.
– TP1, TP2, TP3 are multiples of this base unit, so all targets are tied to volatility and structure, not random numbers.

This makes the levels more realistic for intraday trading compared to simple R-multiples.

────────────────────
7. Execution control
────────────────────
• Only one active trade at a time can be enforced if desired.
• The script can block opening a new trade in the same direction while the previous one is still active.
• OBs can expire on first touch if the user prefers to keep the chart clean.

────────────────────
8. Trade panel & statistics
────────────────────
The script includes a compact on-chart table showing:

• Direction: LONG / SHORT
• Entry price
• Stop-Loss
• TP1, TP2, TP3
• Current trade status:
– “Waiting”, “In play”, “TP1 hit”, “TP2 hit”, “TP3 hit”, “SL hit”, etc.
• Rolling win rate (WR) over the last 100 trades, based on TP1 vs SL.

This allows traders to visually follow the logic of the system and its recent performance without having to read code.

────────────────────
9. Alerts and automation
────────────────────
The indicator exposes alert conditions for:

• New bullish / bearish OB
• Mitigation of bullish / bearish OB
• Trade entry signals (LONG / SHORT)

It can also format alerts as JSON-style messages containing entry, SL and TP levels, so that external tools, webhooks or custom bots can parse and act on them. This makes it easier to connect the script to automated execution, while the trade logic and risk parameters remain fully controlled inside the indicator.

────────────────────
10. Usage notes
────────────────────
• Recommended environment: intraday crypto or FX on 15m–1h.
• Best use cases:
– Focusing on high-quality OBs with structural and Fib/OTE confluence.
– Using the generated Entry/SL/TP1–TP3 as a consistent intraday playbook.
– Feeding signals into external automation via alerts.

This script is not a guarantee of profits and is not financial advice. It is a framework that formalizes a specific Smart Money style approach (BOS → OB/HOB → mitigation → confluence → structured targets) so traders can apply it systematically in their own strategies.