Titan Command: Macro-Quant Sniper Engine

TITAN COMMAND: Macro-Quant Sniper Engine
==========================================

## ⚔️ Institutional Intelligence for the Retail Trader

**Titan Command** is not just an indicator; it is a comprehensive **Algorithmic Trading Operating System** designed to bridge the gap between retail technical analysis and institutional global macro strategies.

Built on the philosophy that *"Price is the slave of Macroeconomics"*, this engine fuses real-time economic data (Yields, DXY, VIX) with advanced quantitative statistics (Z-Scores, Bayesian Probability) to deliver high-precision execution on lower timeframes (specifically optimized for **XAUUSD M5**).

---

## 🧠 The 4-Pillar Architecture

This script operates like a virtual "Hedge Fund Team" inside your chart, consisting of four distinct logic engines that run simultaneously:

### 1. 🌐 The Macro Analyst (Regime Filter)
It doesn't just look at the chart. It "steps out" to analyze the global money flow in real-time.
* **Data Fusion:** Monitors **US10Y** (Bond Yields), **DXY** (Dollar Strength), **VIX** (Fear Index), and **SPX** (Risk Sentiment).
* **Logic:** Detects "Risk-On" vs "Risk-Off" regimes. If Global Macro dictates that Gold should fall (e.g., Yields spiking), the system blocks Buy signals to prevent "Bull Traps".

### 2. 🧮 The Quant Engine (Statistical Core)
Opinions are replaced by math.
* **Z-Score Normalization:** Normalizes price and volume data to detect statistical anomalies (>2 Sigma events).
* **Bayesian Probability:** Calculates a real-time **Confidence Score (0-100%)** based on available evidence. Only setups with high statistical probability trigger a signal.

### 3. 🛡️ The Risk Manager (Capital Protection)
Your safety net against market chaos.
* **Volatility Targeting:** Automatically calculates position size recommendations based on current market volatility (ATR).
* *Calm Market:* Normal Risk.
* *Chaos/News:* Reduces risk to ~0.5% automatically.
* **Smart Take Profit:** Projects dynamic targets based on volatility and quantitative price projection models.

### 4. 🎯 The Sniper (Execution & Timing)
The trigger puller. Once Macro and Quant give the "All Clear", this engine hunts for millisecond-perfect entries.
* **VPA 2.0 (Volume Price Analysis):** Distinguishes between **Ignition** (True Moves) and **Churn** (Manipulation).
* **Advanced Divergence Engine:** Detects both **Regular** (Reversal) and **Hidden** (Continuation) divergences with a "Smart Memory" window to sync with entry signals.

---

## 📖 Visual Legend (How to Trade)

The chart is annotated with "Institutional Footprints" to guide your decisions:

### 🚦 Signal Triggers
* 🚀 **IGNITION / BUY**: A high-confidence trend start. Supported by "Ignition Volume" and Macro confirmation.
* *Action:* **ENTRY BUY**.
* ⚡ **DIV+ SELL**: A confirmed reversal short. Supported by structural weakness and bearish divergence.
* *Action:* **ENTRY SELL**.

### 🔍 Market Structure (Divergence)
* 💎 **BULLISH DIV (Diamond):** Price making lower lows while momentum rises. Represents "Value/Discount".
* *Context:* Watch for Buy setups.
* 💣 **BEARISH DIV (Bomb):** Price making higher highs while momentum fades. Represents "Danger/Top".
* *Context:* Tighten stops on Longs, prepare to Short.

### 📊 Volume Events
* 💥 **CLIMAX:** Massive volume with little price progress. Sign of exhaustion.
* *Action:* **TAKE PROFIT**.
* 🌀 **CHURN:** Confusing volume activity (High Effort / Low Result).
* *Action:* **WAIT & SEE**.

---

## ⚙️ Key Features
* **Dynamic Dashboard:** Displays Macro Status, Confidence Score, Rec. Risk, and key levels.
* **Session Filters:** Enhances signals during London/NY "Kill Zones".
* **Risk Regimes:** Background color adapts to visualize market sentiment (Green=Risk-On, Red=Risk-Off).

## ⚠️ Disclaimer
*This tool is for educational and analytical purposes only. Trading financial markets involves significant risk. The "Confidence Score" is a statistical probability derived from past data, not a guarantee of future performance. Always use proper risk management.*