Gold-to-GDX Flow Ratio (Metal vs Miners)

# 📊 Indicator: Gold/GDX Flow Ratio (Metal vs Miners)

🔎 What it does
This indicator tracks the **relative flow of capital between gold and gold miners (GDX ETF)**. By plotting the ratio of gold price to GDX, it shows whether investors are favoring the **metal itself** or the **equities that mine it**.

- **Ratio rising:** Flow favors gold (metal > miners).
- **Ratio falling:** Flow favors miners (miners > metal).
- **Crossovers:** Fast/slow EMA crossovers highlight regime shifts.
- **Z‑score bands:** ±2 standard deviations flag stretched conditions, often precursors to mean reversion.
⚙️ Features
- **Customizable inputs:** Choose spot gold (`XAUUSD`) or futures (`GC1!`), and GDX ETF.
- **Moving averages:** Fast and slow EMAs to define flow regimes.
- **Z‑score overlay:** Detects extremes in the ratio.
- **Alerts:** Triggered on regime flips or exhaustion signals.
- **Prompt flow option:** Displays the current ratio as a clear on‑screen figure for quick read.
🎭 Why it matters
- **Gold vs miners divergence:** Miners often amplify moves in gold, but sometimes decouple. This ratio helps spot those divergences early.
- **Flow diagnostics:** Instead of vague “profit taking” narratives, you see where capital is actually rotating.
- **Tactical entries:** Use resistance/stop‑cluster maps in gold together with this ratio to time miner trades more effectively.
🧭 How to use
1. Add the indicator to your chart.
2. Watch the **ratio trend**: rising = metal strength, falling = miner strength.
3. Use **EMA crossovers** as regime signals.
4. Treat **Z‑score extremes** as caution zones for stretched flows.
5. Combine with your VWAP and resistance overlays for execution discipline.