🤖 AI Impetus EA
Complete User Manual & Setup Guide
🚀 QUICK START GUIDE {#quick-start}
🤖 Full AI Mode Setup
- Complete installation
- Get API keys (see API Setup)
- Configure APIs in EA settings
- Set trading parameters
- Enable desired AI models
- Start trading with AI consensus
- ⚠️ REQUIRES LIVE TRADING - AI fetches real-time data from APIs
💻 INSTALLATION {#installation}
Step 1: MetaTrader 5 Setup
-
Download & Install MT5
- Download from MetaTrader 5
- Install and create account with your broker
-
Enable WebRequest URLs
- Go to Tools → Options → Expert Advisors
- Check "Allow WebRequest for listed URLs"
- Add these URLs:
-
Allow Live Trading
- Check "Allow live trading"
Step 2: EA Installation
-
Copy EA File
- Copy AI_Impetus.ex5 to:
- MT5_Data_Folder/MQL5/Experts/
-
Restart MT5
- Close and restart MetaTrader 5
- EA should appear in Navigator → Expert Advisors
-
Attach to Chart
- Drag EA onto any chart (EURUSD recommended)
- Configure settings (see Configuration)
- Click "OK" to start
🔑 API KEYS SETUP {#api-setup}
1. Claude API (Anthropic) - RECOMMENDED
Getting API Key:
- Visit console.anthropic.com
- Sign up or log in
- Go to "API Keys" section
- Click "Create Key"
- Copy the key (starts with sk-ant- )
Configuration:
- API Key: sk-ant-api03-xxxxx
- Model: Claude 3 Haiku (fastest/cheapest) or Claude 3.5 Sonnet (best quality)
- Cost: ~$0.001-0.01 per query
2. OpenAI API
Getting API Key:
- Visit platform.openai.com
- Sign up and verify account
- Go to "API Keys" section
- Click "Create new secret key"
- Copy the key (starts with sk- )
Configuration:
- API Key: sk-xxxxx
- Model: GPT-3.5 Turbo (cheapest) or GPT-4o (best)
- Cost: ~$0.002-0.03 per query
3. Grok API (X.AI)
Getting API Key:
- Visit x.ai
- Sign up for API access
- Get API key from dashboard
- Copy key
Configuration:
- API Key: Your X.AI API key
- Model: Grok-3-Mini-Fast (fastest)
- Cost: ~$0.001-0.01 per query
4. DeepSeek API
Getting API Key:
- Visit platform.deepseek.com
- Register account
- Go to API section
- Generate API key
Configuration:
- API Key: Your DeepSeek key
- Model: DeepSeek Chat
- Cost: Very low (~$0.0001 per query)
5. Mistral AI API
Getting API Key:
- Visit console.mistral.ai
- Create account
- Get API key from dashboard
Configuration:
- API Key: Your Mistral key
- Model: Mistral Tiny (cheapest)
- Cost: ~$0.001 per query
6. Groq API (for Llama)
Getting API Key:
- Visit console.groq.com
- Sign up for free account
- Get API key
Configuration:
- API Key: Your Groq key
- Provider: Groq
- Model: Llama 3.1 8B (fast & free)
- Cost: FREE with rate limits
7. Google Gemini API
Getting API Key:
- Visit aistudio.google.com
- Sign in with Google account
- Go to "Get API key"
- Create new key
Configuration:
- API Key: Your Google API key
- Model: Gemini 1.5 Flash (fast)
- Cost: Free tier available
⚙️ EA CONFIGURATION {#configuration}
API Keys Section
InpClaudeAPI = "sk-ant-api03-xxxxx" // Claude API Key
InpOpenAIAPI = "sk-xxxxx" // OpenAI API Key
InpGrokAPI = "your-grok-key" // Grok API Key
InpDeepSeekAPI = "your-deepseek-key" // DeepSeek API Key
InpMistralAPI = "your-mistral-key" // Mistral API Key
InpGroqAPI = "your-groq-key" // Groq API Key (for Llama)
InpGeminiAPI = "your-gemini-key" // Google Gemini API Key
AI Activation
InpUseClaude = true // Enable Claude
InpUseOpenAI = true // Enable OpenAI
InpUseGrok = true // Enable Grok
InpUseDeepSeek = false // Enable DeepSeek (optional)
InpUseMistral = false // Enable Mistral (optional)
InpUseLlama = false // Enable Llama (optional)
InpUseGemini = false // Enable Gemini (optional)
Recommended Starter Configuration
// Enable only 3 AIs for cost efficiency
InpUseClaude = true // Primary AI
InpUseOpenAI = true //Secondary AI
InpUseGrok = true //
Third AI Others = false
// Consensus settings
InpMinAIConsensus = 2 // Require 2 out of 3 AIs to agree
// Basic trading
InpLotSize = 0.01 // Start small
InpMaxSpread = 30 // Points
InpQueryInterval = 900 // 15 minutes
📊 TRADING PARAMETERS {#trading-parameters}
Core Trading Settings
| Parameter | Default | Description |
|---|---|---|
| InpMinAIConsensus | 2 | Minimum AIs that must agree (2-7) |
| InpLotSize | 0.01 | Base lot size for trades |
| InpMagicNumber | 123456 | Unique identifier for EA trades |
| InpMaxSpread | 30 | Maximum spread in points |
| InpQueryInterval | 900 | Seconds between AI queries (15 min) |
| InpMaxOpenSymbols | 8 | Maximum currency pairs to trade |
Grid System Settings
| Parameter | Default | Description |
|---|---|---|
| InpUseGrid | true | Enable grid trading |
| InpGridMode | Progressive | Fixed/Progressive/Martingale |
| InpGridDistance | 60 | Pips between grid levels |
| InpMaxGridLevels | 8 | Maximum grid levels (SAFETY LIMIT) |
| InpGridCommonTPDollar | 2 | Take profit target in dollars |
Grid Modes Explained
-
Fixed Lot: Same lot size for all grid levels
- Level 0: 0.01 lots
- Level 1: 0.01 lots
- Level 2: 0.01 lots
-
Progressive (Additive): Increasing lot sizes
- Level 0: 0.01 lots
- Level 1: 0.02 lots
- Level 2: 0.03 lots
-
Martingale (Multiplicative): Exponential increase
- Level 0: 0.01 lots
- Level 1: 0.02 lots
- Level 2: 0.04 lots
🛡️ RISK MANAGEMENT {#risk-management}
Safety Parameters
| Parameter | Default | Description |
|---|---|---|
| InpMaxLotSizePerPosition | 0.1 | Maximum lot size per single trade |
| InpMaxTotalLotSize | 0.5 | Maximum total lots per symbol |
| InpMaxDrawdownPercent | 5.0 | Maximum account drawdown % |
| InpMaxDailyLoss | 50.0 | Daily loss limit in account currency |
| InpEnableAccountProtection | true | Enable all safety features |
Take Profit / Stop Loss
Manual Mode:
InpUseVolatilityAdjustment = false
InpManualTPPips = 30 // Fixed TP in pips
InpManualSLPips = 20 // Fixed SL in pips
Volatility Mode (Recommended):
InpUseVolatilityAdjustment = true
InpATRPeriod = 14 // ATR calculation period
InpVolatilityTPMultiplier = 2.0 // TP = ATR × 2.0
InpVolatilitySLMultiplier = 1.5 // SL = ATR × 1.5
InpMinVolatilityTP = 20.0 // Minimum TP in pips
InpMaxVolatilityTP = 100.0 // Maximum TP in pips
Account Size Recommendations
| Account Size | Lot Size | Grid Levels | Daily Loss Limit |
|---|---|---|---|
| $100-500 | 0.01 | Max 5 | $10-25 |
| $500-2000 | 0.01-0.02 | Max 6 | $25-50 |
| $2000-5000 | 0.02-0.05 | Max 7 | $50-100 |
| $5000+ | 0.05-0.1 | Max 8 | $100-200 |
📈 MONITORING & DASHBOARD {#monitoring}
Live Dashboard Features
The EA displays a professional dashboard showing:
Column 1 - Trading Status:
- Current mode (AI/Technical/Protected)
- Active AI count
- Current trading symbol and direction
- Open symbols count
- Next query countdown
- Safety limits status
- Grid status and statistics
- Account balance and equity
Column 2 - AI Status:
- Consensus count
- Individual AI statuses
- Success/Error indicators
- Last predictions
Grid Information
- Grid mode (FIXED/PROG+/MART×)
- Current positions count
- Maximum grid level reached
- Grid profit/loss
- Rescue mode status
Key Status Indicators
| Color | Meaning |
|---|---|
| 🟢 Green | Successful/Active |
| 🔴 Red | Error/Loss |
| 🟠 Orange | Warning/Caution |
| ⚪ Gray | Inactive/Neutral |
| 🟡 Yellow | Information |
🔧 TROUBLESHOOTING {#troubleshooting}
Common Issues & Solutions
1. "API Error" Messages
- ✅ Check API key is correct
- ✅ Verify WebRequest URLs are enabled
- ✅ Check internet connection
- ✅ Ensure API has credit/balance
2. "No Trading Activity"
- ✅ Verify AI consensus settings (reduce if needed)
- ✅ Check spread limits
- ✅ Ensure sufficient account balance
- ✅ Check market hours
3. "Grid Not Working"
- ✅ Enable grid system in settings
- ✅ Check grid parameters
- ✅ Verify lot size settings
- ✅ Check account protection limits
4. "Account Protection Active"
- ✅ Check drawdown percentage
- ✅ Review daily loss limits
- ✅ Verify account balance
- ✅ Adjust safety parameters if needed
5. "AI Mode Not Working in Backtester"
- ⚠️ AI mode requires live internet connection
- ✅ Use Technical Mode for backtesting
- ✅ AI mode only works in live/demo with internet
- ✅ Switch to Technical Mode for strategy testing
Error Codes
| Error | Solution |
|---|---|
| 400 | Invalid API request - check API key |
| 401 | Unauthorized - verify API key |
| 429 | Rate limit exceeded - wait or upgrade plan |
| 500 | Server error - try again later |
| Network/Timeout | Check internet connection |
Performance Optimization
For Better Results:
- Use ECN/STP broker accounts
- Enable all safety features
- Start with small lot sizes
- Monitor during high-volatility periods
- Keep API balances topped up
Cost Optimization:
- Use cheaper AI models (Claude Haiku, GPT-3.5)
- Increase query intervals
- Reduce number of active AIs
❓ FREQUENTLY ASKED QUESTIONS {#faq}
General Questions
Q: Can I run this EA without API keys? A: Yes! The EA includes Technical Mode that uses built-in indicators. But not recommended.
Q: Can I backtest the full AI mode? A: No, the AI mode requires live internet connection to fetch real-time data from AI APIs.
Q: How much do API calls cost? A: Very minimal - typically $1-5 per month depending on trading frequency and models used.
Q: What's the minimum account size? A: $1000 minimum, but $5000+ recommended for better risk management.
Q: Does it work on demo accounts? A: Yes, fully compatible with demo accounts. AI mode works on demo if you have API keys, but requires internet connection.
Setup Questions
Q: WebRequest not working? A: Ensure all API URLs are added to MT5 WebRequest whitelist and "Allow WebRequest" is checked.
Q: Can I modify the currency pairs? A: Yes, edit the InpCurrencyPairs parameter with your preferred pairs.
🎯 QUICK SETUP CHECKLIST
Basic Setup (5 minutes) - FOR BACKTESTING & DEMO
- [ ] Install EA in MT5
- [ ] Enable WebRequest URLs
- [ ] Set lot size to 0.01
- [ ] Attach to EURUSD chart
Full AI Setup (30 minutes) - FOR LIVE TRADING ONLY
- [ ] Get Claude API key (primary)
- [ ] Get OpenAI API key (secondary)
- [ ] Get another API key
- [ ] Configure API keys in EA
- [ ] Set consensus to 2-3 depening on amount of API keys
- [ ] Test with small lot size
- [ ] Monitor dashboard
- [ ] ✅ Full AI trading active!
- [ ] ⚠️ Requires live internet connection - no backtesting possible
📞 SUPPORT & RESOURCES
Live Signal: MQL5 Signal #2319393
MQL5 Profile: Contact via MQL5 messaging
---------------
⚠️ DISCLAIMER
🚨 TRADING RISK WARNING
Trading foreign exchange, cryptocurrencies, and other financial instruments involves substantial risk and may not be suitable for all investors. You should carefully consider your financial situation and consult with financial advisors before using this software.
KEY RISKS:
- Past performance does not guarantee future results - You may lose some or all of your invested capital - AI predictions are not guaranteed to be accurate - Market conditions can change rapidly and unpredictably - Automated trading systems can malfunction or produce unexpected results
🤖 AI TECHNOLOGY DISCLAIMER
This software uses artificial intelligence models from third-party providers (Claude, OpenAI, Grok, etc.). Please note:
- AI responses are not financial advice - AI models can produce incorrect or inconsistent results - API costs are separate and charged by AI providers - AI services may be temporarily unavailable - No guarantee of AI model accuracy or reliability
💰 FINANCIAL DISCLAIMER
NO GUARANTEE OF PROFITS:
- This software does not guarantee profits or prevent losses - Results may vary significantly between users - Market conditions affect all trading strategies - Only trade with money you can afford to lose
BACKTESTING LIMITATION:
- Full functions of this product CANNOT be backtested due to live AI API queries. Only technical indicators are used in the backtest! - Historical performance cannot be simulated with AI
- Demo testing is recommended before live trading
🔧 TECHNICAL DISCLAIMER
SOFTWARE DEPENDENCIES:
- Requires stable internet connection for AI APIs - Dependent on third-party AI service availability - WebRequest must be properly configured in MT5 - Valid API keys required for functionality - Software performance depends on broker and platform stability
NO WARRANTY:
- Software provided "as is" without warranty - Author not responsible for technical failures - User responsible for proper configuration and usage
📊 VERSION-SPECIFIC DISCLAIMERS
- Automated trading involves additional risks - User must monitor system performance - Emergency stops may not prevent all losses - Grid trading can amplify both profits and losses
🌍 REGULATORY DISCLAIMER
LEGAL COMPLIANCE:
- User responsible for compliance with local regulations - Some jurisdictions restrict or prohibit automated trading - Verify legal status in your country before use - Author not responsible for regulatory violations
📞 SUPPORT DISCLAIMER
SUPPORT LIMITATIONS:
- No guarantee of 24/7 support availability - Support does not include financial advice - Author not responsible for user trading decisions - Documentation and setup guides provided "as is"
🛡️ LIABILITY LIMITATION
The author, developer, and distributor of this software:
- Disclaim all warranties, express or implied - Are not liable for any direct, indirect, or consequential damages - Are not responsible for trading losses or missed opportunities - Provide software for educational and analytical purposes
✅ USER ACKNOWLEDGMENT
By purchasing and using this software, you acknowledge that:
- You have read and understood all risks - You will not hold the author liable for trading results - You understand this is not financial advice - You will trade responsibly and within your means - You accept full responsibility for your trading decisions
📅 EFFECTIVE DATE: This disclaimer is effective as of the date of purchase and use of the software.
🔄 UPDATES: This disclaimer may be updated without notice. Users are responsible for reviewing current terms.
💡 RECOMMENDATION: Start with demo trading, use small position sizes, and never risk more than you can afford to lose.
🎯 REMEMBER: This software is a tool to assist in analysis and trading decisions. The final trading decisions and their consequences remain entirely your responsibility.
