📊 VIX Scanner (Accumulator Trade Monitor)

A high-performance, real-time volatility monitoring dashboard for Deriv Synthetic Indices, specifically engineered for Accumulator Options trading.

🚀 Key Features

• 🌐 Dynamic Symbol Discovery: Automatically fetches all available synthetic indices from the Deriv API.
• 🔍 Smart Accumulator Filtering: Only monitors symbols that currently support "Accumulator" contract types.
• ⚡ Ultra-Low Latency: 0.1s broadcast interval for near-instant responsiveness.
• 🧠 GARCH(1,1) Forecasting: Advanced statistical modeling to predict volatility shifts in the next 1-2 minutes.
• 🎨 Premium UI/UX: Professional dashboard with color-coded urgency, smooth transitions, and layout-stable price ticks.
• 📦 Unified Startup: Single command to launch both backend and frontend services.

🛠️ Tech Stack

• Backend: Python 3.10+, FastAPI, Websockets, NumPy, Pandas, Arch (GARCH Modeling).
• Frontend: Next.js 14 (App Router), TypeScript, Tailwind CSS, Shadcn/UI, Lucide Icons.
• Data Source: Deriv API (WebSocket).

📥 Installation & Setup

1. Prerequisites

• Python 3.10 or higher
• Node.js 18 or higher
• A Deriv API App ID (default is 123343)

2. Quick Start

The project includes a unified PowerShell script for easy startup on Windows:

.\run.ps1

This will automatically:

1. Initialize the Python virtual environment and install dependencies.
2. Install frontend dependencies.
3. Start the FastAPI backend on http://localhost:8000.
4. Start the Next.js frontend on http://localhost:3000.

📈 Score Interpretation

The composite Volatility Score (0-100) is calculated using a weighted combination of GARCH forecasts, Bollinger Band compression, ATR percentiles, and RVI direction.

Score	Color	Signal	Market Condition
70-100	🟢 Green	ENTER	Low volatility / Accumulator Ideal
50-69	🟡 Yellow	WATCH	Stable / Approaching ideal
35-49	🟠 Orange	CAUTION	Rising volatility / Increased risk
0-34	🔴 Red	AVOID	Extreme volatility / High crash risk

📂 Project Structure

vix-scanner/
├── backend/                # FastAPI & GARCH Core
│   ├── calculators/        # Stat engines (GARCH, BB, ATR)
│   ├── core/               # Coordinator & per-symbol logic
│   ├── models/             # Rolling tick storage
│   ├── config.py           # Configuration constants
│   └── main.py             # Server & Discovery logic
├── frontend/               # Next.js Dashboard
│   ├── src/components/     # UI & Dashboard elements
│   └── src/hooks/          # WebSocket & state management
├── docs/                   # 📚 Technical & Strategy Documentation
└── run.ps1                 # Unified startup script

📚 Documentation

Detailed documentation is available in the docs/ folder:

• 🏗️ Technical Breakdown: System architecture, data flow, and predictive modeling details.
• 🏄 Game Strategy Guide: How to use VIX Scanner with TradeWaveRider for safer gameplay.

📝 Configuration

Advanced settings can be modified in backend/config.py:

• BROADCAST_INTERVAL_SECONDS: Set to 0.1 for high-frequency mode.
• DERIV_CONFIG['app_id']: Set your custom Deriv App ID.

---

⚠️ Disclaimer: This tool is for educational and personal use only. Trading involves significant risk of loss. The developers are not responsible for any financial losses incurred while using this software.

📜 License

This project is licensed under a Personal Use License.

See the LICENSE file for the full text.

Caution

Commercial use is strictly prohibited without prior written consent from the author.

---

Created with ❤️ by Dineth