Zenith-FX/MQL5/Experts/QuantumForexTrader/docs/QUICKSTART_QUANTUM.md
copilot-swe-agent[bot] 43b875366c Reorganize Quantum EA into proper MT5 directory structure
Co-authored-by: simonokwundue-ops <243668919+simonokwundue-ops@users.noreply.github.com>
2025-11-14 16:05:58 +00:00

195 lines
5.1 KiB
Markdown

# Quantum Forex Trader - Quick Start Guide
## 5-Minute Setup for Beginners
### Step 1: Install Files (2 minutes)
1. **Find your MT5 data folder:**
- Open MetaTrader 5
- Click: File → Open Data Folder
- Navigate to: MQL5 → Experts
2. **Copy the QuantumForexTrader folder to the Experts directory:**
- Copy the entire `MQL5/Experts/QuantumForexTrader/` folder
- Paste into your MT5 Experts folder
- Final path: `[MT5_DATA]\MQL5\Experts\QuantumForexTrader\`
### Step 2: Compile (1 minute)
1. Press **F4** in MT5 to open MetaEditor
2. In Navigator, expand **Experts****QuantumForexTrader**
3. Double-click **QuantumForexTrader_Scalper.mq5** to open it
4. Press **F7** to compile
5. Check bottom panel: Should show "**0 error(s), 0 warning(s)**"
6. Close MetaEditor
### Step 3: Attach to Chart (2 minutes)
1. Open **EUR/USD** chart in MT5
2. Change timeframe to **H1** (1 Hour)
3. In Navigator, expand "Expert Advisors" → "QuantumForexTrader"
4. **Drag** QuantumForexTrader_Scalper onto the chart
5. In the dialog that appears:
- **Common tab**: Check "Allow Algo Trading" ✓
- **Inputs tab**: Leave everything default for now
- Click **OK**
### Step 4: Verify It's Working (30 seconds)
Look for these signs:
-**Smiley face** in top-right corner of chart (good!)
- ✗ If you see an X, click the **"Algo Trading"** button in toolbar
- Check **Toolbox****Experts** tab for initialization messages
## Expected Log Messages
When EA starts successfully, you'll see:
```
=== Quantum Forex Trader Initializing ===
Symbol: EURUSD
Timeframe: H1
Account Balance: [your balance]
=== Configuration ===
History Bars: 256
Confidence Threshold: 3.0%
Risk Per Trade: 1.0%
=== Quantum Forex Trader Initialized Successfully ===
```
## What Happens Next?
The EA will:
1. **Wait 60 seconds** between signal checks
2. **Analyze 256 bars** of price history
3. **Generate signals** when conditions are met
4. **Open trades automatically** with SL and TP
**Time to first trade**: Could be 1 hour to 1 day depending on market conditions
## Recommended First Settings
For **demo testing** (start here!):
| Parameter | Value | Why |
|-----------|-------|-----|
| Symbol | EUR/USD | Most liquid, lowest spread |
| Timeframe | H1 | Good balance |
| Risk % | 0.5% | Very conservative |
| Max Positions | 1 | Safest start |
| Stop Loss | 50 pips | Reasonable for EUR/USD |
| Take Profit | 100 pips | 2:1 reward ratio |
## Common Issues & Quick Fixes
### Issue: EA shows ✗ instead of ☺
**Fix**: Click "Algo Trading" button in toolbar (should turn green)
### Issue: No trades after several hours
**Possible reasons**:
- Market conditions don't meet criteria (normal)
- Spread too wide (wait for better conditions)
- Outside trading hours (check time filter settings)
**Action**: Be patient! Check Experts log for "SIGNAL DETECTED" messages
### Issue: Compilation errors
**Fix**:
1. Ensure ALL 5 files (.mq5 and .mqh) are in Experts folder
2. Check file extensions (not .txt)
3. Re-download files if corrupted
## Safety Checklist
Before going live:
- [ ] Tested on **demo** account for at least 1-2 weeks
- [ ] Understand all parameter settings
- [ ] Started with **conservative** settings (0.5-1% risk)
- [ ] Checked Experts log shows no errors
- [ ] Account balance sufficient ($500+ recommended)
- [ ] Using **major pair** (EUR/USD, GBP/USD, USD/JPY)
- [ ] Monitoring daily for first week
## Quick Reference: Parameter Presets
### Ultra Conservative (Recommended for beginners)
```
InpRiskPercent = 0.5
InpMaxPositions = 1
InpConfidenceThreshold = 0.05
InpMomentumThreshold = 0.15
```
### Conservative
```
InpRiskPercent = 1.0
InpMaxPositions = 1
InpConfidenceThreshold = 0.04
InpMomentumThreshold = 0.12
```
### Moderate
```
InpRiskPercent = 1.5
InpMaxPositions = 2
InpConfidenceThreshold = 0.03
InpMomentumThreshold = 0.10
```
### Aggressive (Not recommended for beginners!)
```
InpRiskPercent = 2.0
InpMaxPositions = 3
InpConfidenceThreshold = 0.02
InpMomentumThreshold = 0.08
```
## Monitoring Dashboard
Check these metrics daily:
| Metric | What to Look For | Action If... |
|--------|------------------|--------------|
| Balance | Increasing over time | Keep going! |
| Equity | Close to balance | Normal |
| Drawdown | < 20% | Good |
| Open Positions | Within max limit | Normal |
| Smiley Face | ☺ showing | EA active |
## Need More Help?
1. **Full instructions**: Read USER_MANUAL.txt
2. **Technical details**: Read QUANTUM_EA_README.md
3. **Troubleshooting**: See USER_MANUAL.txt section 9
4. **FAQ**: See USER_MANUAL.txt section 10
## Remember
**DO:**
- Test on demo first
- Start conservative
- Monitor regularly
- Keep learning
**DON'T:**
- Use on live without testing
- Risk more than 2% per trade
- Disable risk management
- Panic on first loss
## Next Steps
After 1-2 weeks of demo testing:
1. Review trade history
2. Check win rate (aim for >50%)
3. Verify drawdown stayed under limit
4. If satisfied, consider live with small account
5. Start with same conservative settings
6. Gradually adjust based on results
---
**Questions?** Read the complete USER_MANUAL.txt file!
**Ready?** Let's start trading! 🚀