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

5.1 KiB

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 ExpertsQuantumForexTrader
  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 ToolboxExperts 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

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

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
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! 🚀