mirror of
https://github.com/rithsila/MT5-EA-Sniper-Strategy.git
synced 2026-08-14 03:08:08 +00:00
rithsila
e20b066d60
- Updated session input parameters with Cambodia timezone (GMT+7) - Modified GetCurrentSession() function to use Cambodia time offset - Adjusted session times to avoid midnight crossover complexity: * Asia Session: 07:00-16:00 Cambodia Time * London Session: 15:00-23:59 Cambodia Time * New York Session: 20:00-23:59 Cambodia Time - Updated documentation (README.md, PRD.md) to reflect timezone changes - Added debug logging for timezone verification - Prepared for Phase 3 implementation with proper Cambodia timezone support
261 lines
8.3 KiB
Markdown
261 lines
8.3 KiB
Markdown
# 🎯 MT5 Sniper EA - Smart Money Concepts Trading System
|
|
|
|
[](https://github.com/rithsila/MT5-EA-Sniper-Strategy)
|
|
[](https://github.com/rithsila/MT5-EA-Sniper-Strategy/releases)
|
|
[](LICENSE)
|
|
[](https://www.metatrader5.com/)
|
|
|
|
> **Professional-grade Expert Advisor implementing advanced Smart Money Concepts with multi-timeframe analysis for institutional-quality trading.**
|
|
|
|
## 🚀 **Project Status**
|
|
|
|
- **✅ Phase 1 (Core Trading Logic)**: 100% Complete
|
|
- **✅ Phase 2 (Multi-Timeframe Integration)**: 100% Complete
|
|
- **📊 Overall Completion**: 95%
|
|
- **🎯 Production Status**: Ready for Live Trading
|
|
|
|
## 📋 **Table of Contents**
|
|
|
|
- [Features](#-features)
|
|
- [Installation](#-installation)
|
|
- [Quick Start](#-quick-start)
|
|
- [Configuration](#-configuration)
|
|
- [Trading Strategy](#-trading-strategy)
|
|
- [Performance](#-performance)
|
|
- [Documentation](#-documentation)
|
|
- [Contributing](#-contributing)
|
|
- [License](#-license)
|
|
|
|
## ✨ **Features**
|
|
|
|
### 🎯 **Core Smart Money Concepts**
|
|
|
|
- **Order Blocks Detection**: Institutional supply/demand zones
|
|
- **Fair Value Gaps (FVG)**: Market inefficiency identification
|
|
- **Break of Structure (BOS)**: Trend change confirmation
|
|
- **Liquidity Sweeps**: Stop hunt detection and exploitation
|
|
|
|
### 📊 **Multi-Timeframe Analysis**
|
|
|
|
- **5 Timeframes**: M1, M15, H4, D1, W1 analysis
|
|
- **Bias Calculation**: Advanced strength scoring (0-100 scale)
|
|
- **Bias Change Detection**: Historical tracking with thresholds
|
|
- **Major Levels**: Key support/resistance identification
|
|
|
|
### 🛡️ **Professional Risk Management**
|
|
|
|
- **Position Sizing**: 1% risk per trade (configurable)
|
|
- **Risk-Reward**: 2:1 minimum ratio
|
|
- **Daily Limits**: Maximum 3 trades per symbol
|
|
- **Emergency Stops**: Comprehensive protection system
|
|
|
|
### 🔧 **Advanced Features**
|
|
|
|
- **Multi-Symbol Processing**: 8 major pairs simultaneously
|
|
- **Session Filtering**: Asia, London, New York sessions
|
|
- **Real-time Monitoring**: Comprehensive logging system
|
|
- **Performance Tracking**: Detailed analytics and reporting
|
|
|
|
## 🔧 **Installation**
|
|
|
|
### **Prerequisites**
|
|
|
|
- MetaTrader 5 platform
|
|
- Windows 10/11 (recommended)
|
|
- Minimum 4GB RAM
|
|
- Stable internet connection
|
|
|
|
### **Installation Steps**
|
|
|
|
1. **Clone the Repository**
|
|
|
|
```bash
|
|
git clone https://github.com/rithsila/MT5-EA-Sniper-Strategy.git
|
|
cd MT5-EA-Sniper-Strategy
|
|
```
|
|
|
|
2. **Copy EA to MT5**
|
|
|
|
```bash
|
|
# Copy to MT5 Experts folder
|
|
copy src\SniperEA.mq5 "C:\Users\%USERNAME%\AppData\Roaming\MetaQuotes\Terminal\[TERMINAL_ID]\MQL5\Experts\"
|
|
```
|
|
|
|
3. **Compile the EA**
|
|
|
|
```bash
|
|
# Using PowerShell build script
|
|
.\build.ps1
|
|
```
|
|
|
|
4. **Attach to Chart**
|
|
- Open MT5 platform
|
|
- Navigate to Navigator → Expert Advisors
|
|
- Drag SniperEA to your chart
|
|
- Configure parameters and enable auto-trading
|
|
|
|
## 🚀 **Quick Start**
|
|
|
|
### **Basic Configuration**
|
|
|
|
```mql5
|
|
// Risk Management
|
|
RiskPercent = 1.0 // 1% risk per trade
|
|
MinRR = 2.0 // Minimum 2:1 risk-reward
|
|
MaxTradesPerDay = 3 // Maximum trades per symbol
|
|
|
|
// Phase 2 Settings
|
|
MinBiasStrength = 60.0 // Minimum bias strength (0-100)
|
|
EnableBiasChangeDetection = true
|
|
EnableMajorLevelsFilter = true
|
|
```
|
|
|
|
### **Recommended Symbols**
|
|
|
|
- **Major Pairs**: EURUSD, GBPUSD, USDJPY, USDCHF
|
|
- **Commodity**: XAUUSD (Gold)
|
|
- **Cross Pairs**: AUDUSD, USDCAD, NZDUSD
|
|
|
|
### **Optimal Timeframes**
|
|
|
|
- **Primary**: M1 (for entries)
|
|
- **Analysis**: M15, H4, D1, W1 (for bias confirmation)
|
|
|
|
## ⚙️ **Configuration**
|
|
|
|
### **Input Parameters**
|
|
|
|
| Parameter | Default | Description |
|
|
| --------------------------- | ------- | --------------------------------- |
|
|
| `RiskPercent` | 1.0 | Risk percentage per trade |
|
|
| `MinRR` | 2.0 | Minimum risk-reward ratio |
|
|
| `MaxTradesPerDay` | 3 | Daily trade limit per symbol |
|
|
| `UseTimeFilter` | false | Enable session filtering |
|
|
| `MinBiasStrength` | 60.0 | Minimum bias strength for trading |
|
|
| `BiasHistoryPeriods` | 10 | Bias history tracking periods |
|
|
| `EnableBiasChangeDetection` | true | Enable bias change alerts |
|
|
| `EnableMajorLevelsFilter` | true | Filter trades by major levels |
|
|
|
|
### **Session Settings**
|
|
|
|
```mql5
|
|
// Trading Sessions (Cambodia Time GMT+7)
|
|
AsiaStart = "07:00" // Asia session start
|
|
AsiaEnd = "16:00" // Asia session end
|
|
LondonStart = "15:00" // London session start
|
|
LondonEnd = "23:59" // London session end
|
|
NewYorkStart = "20:00" // New York session start
|
|
NewYorkEnd = "23:59" // New York session end
|
|
```
|
|
|
|
## 📈 **Trading Strategy**
|
|
|
|
### **Entry Criteria**
|
|
|
|
1. **Liquidity Sweep**: Stop hunt confirmation
|
|
2. **Break of Structure**: Trend change validation
|
|
3. **Fair Value Gap**: Market inefficiency present
|
|
4. **Order Block**: Fresh institutional zone
|
|
5. **Multi-Timeframe Bias**: HTF confirmation aligned
|
|
|
|
### **Trade Management**
|
|
|
|
- **Entry**: Market execution at optimal price
|
|
- **Stop Loss**: Beyond Order Block or sweep level
|
|
- **Take Profit**: 2:1 to 3:1 risk-reward ratio
|
|
- **Position Size**: 1% account risk per trade
|
|
|
|
### **Pattern Sequence**
|
|
|
|
```
|
|
Liquidity Sweep → Break of Structure → Fair Value Gap → Order Block → ENTRY
|
|
```
|
|
|
|
## 📊 **Performance**
|
|
|
|
### **Testing Results** (7-Day Backtest)
|
|
|
|
- **Pattern Detections**: 1,988,538 total patterns
|
|
- **Order Blocks**: 1,068,185 detected
|
|
- **Fair Value Gaps**: 920,353 detected
|
|
- **System Stability**: 100% uptime
|
|
- **Processing Speed**: 26ms average per tick
|
|
- **Memory Usage**: 1.3GB (multi-symbol processing)
|
|
|
|
### **Technical Metrics**
|
|
|
|
- **Compilation**: 0 errors, 0 warnings ✅
|
|
- **Code Quality**: Professional-grade architecture ✅
|
|
- **Error Handling**: Comprehensive validation ✅
|
|
- **Logging**: Detailed debugging information ✅
|
|
|
|
## 📚 **Documentation**
|
|
|
|
### **Core Documentation**
|
|
|
|
- [Implementation Plan](implementplan.md) - Development roadmap and status
|
|
- [Product Requirements](docs/PRD.md) - Detailed specifications
|
|
- [Testing Guide](docs/TESTING_GUIDE.md) - Comprehensive testing procedures
|
|
|
|
### **Development Guides**
|
|
|
|
- [MT5 EA Development Workflow](docs/MT5_EA_DEVELOPMENT_WORKFLOW.md)
|
|
- [Pattern Validation Framework](docs/PATTERN_VALIDATION_FRAMEWORK.md)
|
|
- [Performance Regression Framework](docs/PERFORMANCE_REGRESSION_FRAMEWORK.md)
|
|
|
|
### **Build & Deployment**
|
|
|
|
- [Compilation Automation](docs/COMPILATION_AUTOMATION.md)
|
|
- [Feature Branch Methodology](docs/FEATURE_BRANCH_METHODOLOGY.md)
|
|
- [Quick Monitoring](docs/QUICK_MONITORING.md)
|
|
|
|
## 🏗️ **Project Structure**
|
|
|
|
```
|
|
MT5-EA-Sniper-Strategy/
|
|
├── src/ # Source code
|
|
│ └── SniperEA.mq5 # Main EA file
|
|
├── docs/ # Documentation
|
|
├── tests/ # Test files and logs (gitignored)
|
|
├── build.ps1 # Build automation script
|
|
├── deploy.ps1 # Deployment script
|
|
├── implementplan.md # Implementation roadmap
|
|
├── README.md # This file
|
|
└── .gitignore # Git ignore rules
|
|
```
|
|
|
|
## 🤝 **Contributing**
|
|
|
|
We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
|
|
|
|
### **Development Setup**
|
|
|
|
1. Fork the repository
|
|
2. Create a feature branch
|
|
3. Make your changes
|
|
4. Test thoroughly
|
|
5. Submit a pull request
|
|
|
|
## 📄 **License**
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
|
|
|
## 🙏 **Acknowledgments**
|
|
|
|
- Smart Money Concepts methodology
|
|
- MetaTrader 5 platform
|
|
- MQL5 community
|
|
- Professional trading community
|
|
|
|
## 📞 **Support**
|
|
|
|
- **Issues**: [GitHub Issues](https://github.com/rithsila/MT5-EA-Sniper-Strategy/issues)
|
|
- **Discussions**: [GitHub Discussions](https://github.com/rithsila/MT5-EA-Sniper-Strategy/discussions)
|
|
- **Documentation**: [Wiki](https://github.com/rithsila/MT5-EA-Sniper-Strategy/wiki)
|
|
|
|
---
|
|
|
|
**⚠️ Risk Disclaimer**: Trading involves substantial risk and may result in loss of capital. Past performance does not guarantee future results. Use this EA at your own risk and ensure proper risk management.
|
|
|
|
**🎯 Ready for Professional Trading!** 🚀
|