Troubleshooting

​

MetaTrader 5 Issues

​

Connection Failed

• Bot fails to start
• Error message: “Failed to initialize MT5”
• No market data displayed

pip install --upgrade MetaTrader5

import MetaTrader5 as mt5
if mt5.initialize():
    print("MT5 initialized successfully")
    mt5.shutdown()
else:
    print("MT5 initialization failed")

​

Symbol Not Found

• Error: “XAUUSD symbol not found”
• No price data for gold

1. Check Symbol Availability:
   • In MT5, right-click Market Watch
   • Select “Symbols”
   • Search for XAUUSD or Gold
   • Ensure it’s visible in Market Watch
2. Verify Symbol Name:
   • Some brokers use different naming: XAUUSD, GOLD, XAUUSD.m
   • Check your broker’s symbol naming convention
   • Update the symbol name in XAUSD_AI.py if needed

​

Data Retrieval Issues

• Incomplete historical data
• Missing timeframe data
• Empty dataframes

​

API Key Issues

​

Invalid Groq API Key

• Error: “Invalid API key”
• Authentication failed
• AI analysis not working

GROQ_API_KEY = "gsk_..."

​

API Connection Timeout

• Request timeout errors
• Slow response from AI
• Connection refused

1. Check internet connection
2. Verify firewall isn’t blocking Groq API
3. Try using a VPN if blocked in your region
4. Increase timeout settings in the code

​

Dependency Issues

​

Package Installation Failures

• pip install errors
• Module not found errors
• Version conflicts

# Create virtual environment
python -m venv venv

# Activate (Windows)
venv\Scripts\activate

# Activate (Linux/Mac)
source venv/bin/activate

# Install requirements
pip install -r requirements.txt

python -m pip install --upgrade pip setuptools wheel
pip install -r requirements.txt

pip install MetaTrader5
pip install pandas numpy
pip install langchain-groq
pip install streamlit

python --version

​

Import Errors

• ModuleNotFoundError
• ImportError
• Missing dependencies

# Verify package installation
pip list | grep -E "MetaTrader5|pandas|numpy|langchain|streamlit"

# Reinstall specific package
pip uninstall <package-name>
pip install <package-name>

# Clear pip cache if needed
pip cache purge
pip install -r requirements.txt

​

Streamlit Dashboard Issues

​

Dashboard Won’t Start

• streamlit run app.py fails
• Port already in use
• Application crashes on startup

# Default Streamlit port is 8501
# Windows
netstat -ano | findstr :8501

# Linux/Mac
lsof -i :8501

streamlit run app.py --server.port 8502

# Clear cache directory
rm -rf ~/.streamlit/cache

# Or use Streamlit command
streamlit cache clear

# Navigate to project directory
cd /path/to/xauusd-trading-bot

# Verify app.py exists
ls -la app.py

# Run Streamlit
streamlit run app.py

​

Dashboard Shows Errors

• Red error messages in dashboard
• Features not working
• No data displayed

1. Check Browser Console:
   • Press F12 in browser
   • Look for JavaScript errors
   • Try different browser
2. Refresh the Page:
   • Click “Rerun” in Streamlit
   • Hard refresh: Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac)
3. Check Logs:
   • Look at terminal where Streamlit is running
   • Check for error messages
   • Debug based on error output

​

Performance Issues

​

Slow Analysis

• Analysis takes too long
• Dashboard freezes
• Timeout errors

​

High Memory Usage

• Clear Python cache regularly
• Restart the Streamlit app periodically
• Limit auto-refresh frequency
• Use smaller data batches

​

Data Accuracy Issues

​

Inconsistent Signals

• Markets are volatile or choppy
• Different timeframes show conflicting signals
• Major news events are occurring

• Signals change drastically within seconds
• Data appears corrupted or unusual
• Indicators show impossible values

1. Verify MT5 data feed is stable
2. Check for broker server issues
3. Compare with MT5’s built-in indicators
4. Ensure sufficient historical data

​

Spread Warnings

• High spread alerts
• “Spread too wide” messages

• During market open/close
• Major news releases
• Low liquidity periods
• Some broker’s typical spreads

​

Getting Additional Help

import logging
logging.basicConfig(level=logging.DEBUG)