Ultimate SMC Dashboard — Pro v2.1 (ICT/SMC)

🔍 1. General Objective of the Script


This script is a complete visual and algorithmic SMC (Smart Money Concepts) analysis system that:

* Automatically identifies market structures (BOS / CHoCH / Liquidity Grab).
* Detects and dynamically maintains Fair Value Gaps (FVG) according to ICT methodology.
* Draws and tracks the evolution of Order Blocks (OB) and Breaker Blocks (BRK).
* Calculates MACD / Volume divergences.
* Analyzes trend, volume, and buyer/seller dominance.
* Displays a clear and dynamic dashboard directly on the chart.
* Builds the foundation for reversal / continuation probability models.

---

⚙️ 2. Input Parameters


The script is highly configurable. Inputs are organized by sections:

Structure (ICT)

* Pivot left/right (swing length) → determines the swing size for HH/LL detection.
* OB lookback → number of candles to look back for an Order Block after a BOS.
* Show BOS / CHoCH / Liquidity Grab → enables or disables structural elements.

Imbalances (FVG)

* Enables the display of Fair Value Gaps.
* Manages minimum size, transparency, and **dynamic reduction** when partially filled.
* Limits the maximum number of FVGs displayed simultaneously.

Order Blocks / Breakers

* Enables Order Blocks and Breaker Blocks.
* Defines their colors, opacity, and dynamic behavior.
* Automatically removes outdated OBs exceeding the maximum limit.

Signal & Probabilities

* Sets the lookback period for structure calculation.
* Calculates average volume (MA) to detect dominance and momentum.
* Defines the probability threshold for signals (not yet visible in this snippet).

RSI / EMA / Divergences / Sentiment

* Prepares additional indicator modules, such as:

* MACD divergence detection
* RSI / EMA visualization
* Market sentiment and funding metrics

---

🧠 3. Market Structure Logic (ICT Core)

a. Pivot Detection

Uses ta.pivothigh and ta.pivotlow to detect Higher Highs (HH) and Lower Lows (LL).

b. Break of Structure (BOS)

A BOS occurs when price breaks a validated swing high or low:

* bullBOS → bullish break.
* bearBOS → bearish break.

c. Change of Character (CHoCH)

A CHoCH is detected when BOS direction changes (e.g., a bullish BOS followed by a bearish BOS).

d. Liquidity Grab

Detection of liquidity sweeps:

* grabUp: wick above the last high, closing below.
* grabDown: wick below the last low, closing above.

All these signals feed into the main trend bias (Bull / Bear / Flat).

---

🧱 4. Fair Value Gaps (FVG)

The FVG logic strictly follows ICT principles:

* Bullish FVG: if `low[0] > high[2]`
* Bearish FVG: if `high[0] < low[2]`

Each FVG becomes a dynamic box:

* Shrinks in real time as price partially fills it.
* Automatically deletes itself once fully closed.
* Color and opacity depend on direction (green = bullish, red = bearish).

This is one of the most complex parts of the code, managing:

* Arrays of box objects (`array<box>`)
* Real-time updates for every candle
* Automatic cleanup to prevent chart overload

---

🧱 5. Order Blocks (OB) and Breaker Blocks

An Order Block is generated:

* After a BOS,
* By identifying the last candle opposite to the trend before the break.

Examples:

* Bullish BOS → Bullish OB = last red candle before the breakout.
* Bearish BOS → Bearish OB = last green candle before the breakdown.

Each OB:

* Is visualized as a colored rectangle (cyan or orange).
* Becomes inactive once mitigated (touched).
* Is removed and converted into a Breaker Block if invalidated (opposite side broken).

The system uses arrays similar to FVGs to maintain visual cleanliness and chart efficiency.

---

📊 6. Volume and Dominance

The script computes:

* A moving average (SMA) of volume.
* Whether the current volume is abnormally high or low.
* Whether candles are buyer- or seller-dominant.

Simplified display:

* 🔥 High Volume
* 📉 Low Volume
* 🟩 Buyers Dominant
* 🟥 Sellers Dominant
* ⚪️ Neutral

---

🧩 7. Textual Dashboard

Text variables such as:

* `struct_txt` → displays BOS, CHoCH, Grab info
* `fvg_txt` → “🟢 Open” or “🔴 Close”
* `ob_txt` → “🟩 Open” or “🟥 Close”

These feed a visual dashboard (not yet displayed in this excerpt), summarizing the entire market state in real time.

---

💡 8. Summary

The script:

* Observes market structure (ICT).
* Automatically draws institutional imbalance and interest zones (OB, FVG).
* Dynamically manages their evolution.
* Provides visual structural, volume, and sentiment signals.
* Builds a complete foundation for a professional ICT/SMC dashboard.