FX-QUANT-SCAN/README.md

# FX-QUANT-SCAN
Access Link:
https://fx-quant-scan-3wvacmjpkn9zkybjmfhbvg.streamlit.app/

Reduce decision fatigue, use FX Quant Scan
Professional FX Analytics & Zone-Based Market Analysis Platform
A comprehensive Streamlit-based web application for foreign exchange market analysis, featuring real-time data visualization, currency strength analysis, and innovative zone-based price evaluation.

Run locally with:
streamlit run scan_x.py

✨ Features
🏠 Dashboard Overview

Professional landing page with platform explanation
Quick stats and feature overview
Zone analysis methodology explanation

📊 FX Heatmap

Real-time percentage changes across 28 major currency pairs
Interactive visualization using Plotly
Market overview for daily trading preparation
Currency strength comparison at a glance

💪 Currency Strength Meter

Individual currency rankings with strength scores
Beautiful interactive charts showing momentum
Strength-based trading insights
Historical strength trends

🎯 Zone Locator ⭐ Unique Feature

Zone-based price analysis using historical support/resistance levels
Fair value assessment - determine if currencies are cheap, fairly priced, or expensive
Historical zone visualization with interactive charts
Risk assessment based on zone positioning
Three main zones: RESET (oversold), BUDGET (fair value), PREMIUM+ (expensive)

🔗 FX Correlation Matrix

Comprehensive 24x24 correlation matrix
Multiple timeframes (7-90 days)
Risk management insights for portfolio diversification
Pair trading opportunities identification

🎯 Zone Analysis Methodology
What Are Trading Zones?
Zones are price ranges defined by historically significant support and resistance levels. Think of them as "neighborhoods" where currency pairs prefer to trade.
Key Concepts:

Historical Analysis: Years of price data identify significant levels
Zone Classification: Price ranges between levels become named zones
Fair Value Discovery: Track which zones pairs spend most time in
Market Positioning: Current location indicates if currency is cheap/expensive

Zone Categories
ZoneIndicatorMeaningStrategy🔴 RESETHistorical LowsPotential oversold conditionsContrarian plays, small positions🟢 BUDGETFair ValueNormal/average pricingMomentum strategies, normal sizing🟠 PREMIUM+Historical HighsExpensive territoryTrend continuation, reduced sizing
🛠️ Technical Stack

Frontend: Streamlit with custom CSS styling
Data Sources: Yahoo Finance API (yfinance)
Visualizations: Plotly (interactive charts)
Zone Data: Excel-based historical level definitions
Architecture: Modular design with separated concerns

📁 Project Structure
QUANT_FRAMEWORK/
├── 📁 viz/                    # Streamlit pages
│   ├── home.py               # Enhanced dashboard  
│   ├── fx_heatmap.py         # Real-time heatmap
│   ├── strength_meter.py     # Currency strength
│   ├── zone_locator.py       # Zone analysis (enhanced)
│   ├── fx_correlation.py     # Correlation matrix
│   └── zone_transitions.py   # [Coming Soon]
├── 📁 core/                   # Business logic
│   └── zone_locator.py       # Zone calculation engine
├── 📁 reports/                # Data exports
│   ├── current_zone_snapshot.csv
│   ├── zone_history.csv
│   └── zone_transition_log.csv
├── 📁 archive/                # Legacy code (archived)
├── 📄 scan_x.py              # Main Streamlit app
└── 📄 requirements.txt       # Dependencies
🚀 Quick Start
Prerequisites

Python 3.8+
pip package manager

Installation

Clone the repository
bashgit clone https://github.com/yourusername/fx-quant-scan.git
cd fx-quant-scan

Install dependencies
bashpip install -r requirements.txt

Run the application
bashstreamlit run scan_x.py

Open your browser
Local URL: http://localhost:8501


📊 Usage Guide
Daily Workflow

📊 Start with FX Heatmap - Get overall market view
💪 Check Currency Strength - Identify moving currencies
🎯 Use Zone Locator - Assess if targets are cheap/expensive
🔗 Verify with Correlations - Risk management check

Pro Tips

Combine zone + strength: Look for strong currencies in budget zones
Use correlation matrix: Avoid highly correlated trades
Monitor zone transitions: Track when pairs move between zones
Historical context: Always consider longer-term zone positioning

🔧 Configuration
Zone Data Setup
Zone definitions are stored in Excel files with historical support/resistance levels:

Each currency pair has defined zone boundaries
Zones are calculated from years of historical price data
Manual updates possible for major market structure changes

Customization

Colors: Modify CSS in individual page files
Timeframes: Adjust in correlation and heatmap modules
Currency Pairs: Add new pairs to zone definition files

📈 Features in Development

🔄 Zone Transitions: Advanced zone change tracking (coming soon)
📱 Mobile Optimization: Improved mobile responsiveness
💾 Data Persistence: Database integration for faster loading
🤖 Strategy Integration: Backtesting capabilities
📧 Alerts: Zone breakout notifications

🤝 Contributing
This is a personal trading tool developed for educational and analysis purposes. Feel free to fork and adapt for your own use.
Development Guidelines

Follow existing code structure in viz/ and core/
Maintain Streamlit best practices
Keep visualizations interactive and professional
Test with multiple currency pairs before committing

⚠️ Disclaimer
This tool is for educational and analysis purposes only.

Not financial advice
Past performance doesn't guarantee future results
Always do your own research
Consider risk management in all trading decisions