Supports MT5 and forex trading.

Signed-off-by: TIANHE <TIANHE@GMAIL.COM>

Author: tianhe

README.md

@@ -97,6 +97,7 @@ QuantDinger includes a built-in **LLM-based multi-agent research system** that g
 ### Guides
 - [Python Strategy Development Guide](docs/STRATEGY_DEV_GUIDE.md)
 - [Interactive Brokers (IBKR) Trading Guide](docs/IBKR_TRADING_GUIDE_EN.md) 🆕
+- [MetaTrader 5 (MT5) Trading Guide](docs/MT5_TRADING_GUIDE_EN.md) 🆕
 
 ### Notification Configuration
 - [Telegram Notification Setup](docs/NOTIFICATION_TELEGRAM_CONFIG_EN.md)
@@ -165,8 +166,11 @@ QuantDinger includes a built-in **LLM-based multi-agent research system** that g
 2.  **Strategy Config**: Attach risk management rules (Position sizing, Stop-Loss, Take-Profit).
 3.  **Backtest & AI Optimization**: Run backtests, view rich performance metrics, and **let AI analyze the result to suggest improvements** (e.g., "Adjust MACD threshold to X").
 4.  **Execution Mode**:
-    - **Live Trading**: Direct API execution for 10+ Crypto Exchanges (Binance, OKX, etc.).
-    - **Signal Notification**: For non-executable markets (Stocks/Forex/Futures), send signals via Telegram, Discord, Email, SMS, or Webhook.
+    - **Live Trading**: 
+      - **Cryptocurrency**: Direct API execution for 10+ exchanges (Binance, OKX, Bitget, Bybit, etc.)
+      - **US/HK Stocks**: Via Interactive Brokers (IBKR) 🆕
+      - **Forex**: Via MetaTrader 5 (MT5) 🆕
+    - **Signal Notification**: For markets without live trading support (A-shares/Futures), send signals via Telegram, Discord, Email, SMS, or Webhook.
 
 ### 3. AI Multi-Agent Research
 *Your 24/7 AI Investment Committee.*
@@ -292,19 +296,32 @@ Config lives in `.env` (see `backend_api_python/env.example`): `ENABLE_AGENT_MEM
 
 ---
 
-## 🔌 Supported Exchanges
+## 🔌 Supported Exchanges & Brokers
 
-QuantDinger supports direct API connections to major cryptocurrency exchanges for execution, and uses CCXT for broad market data coverage.
+QuantDinger supports multiple execution methods for different market types:
 
-### Direct API Support
+### Cryptocurrency Exchanges (Direct API)
 
 | Exchange | Markets |
 |:--------:|:---------|
 | Binance | Spot, Futures, Margin |
 | OKX | Spot, Perpetual, Options |
 | Bitget | Spot, Futures, Copy Trading |
+| Bybit | Spot, Linear Futures |
+| Coinbase Exchange | Spot |
+| Kraken | Spot, Futures |
+| KuCoin | Spot, Futures |
+| Gate.io | Spot, Futures |
+| Bitfinex | Spot, Derivatives |
 
-### Also Supported via CCXT
+### Traditional Brokers
+
+| Broker | Markets | Platform |
+|:------:|:--------|:---------|
+| **Interactive Brokers (IBKR)** | US Stocks, HK Stocks | TWS / IB Gateway 🆕 |
+| **MetaTrader 5 (MT5)** | Forex | MT5 Terminal 🆕 |
+
+### Market Data (via CCXT)
 
 Bybit, Gate.io, Kraken, KuCoin, HTX, and 100+ other exchanges for market data.
 
@@ -339,7 +356,7 @@ All UI elements, error messages, and documentation are fully translated. Languag
 | **US Stocks** | Yahoo Finance, Finnhub, Tiingo | ✅ Via IBKR 🆕 |
 | **HK Stocks** | AkShare, East Money | ✅ Via IBKR 🆕 |
 | **CN Stocks (A-shares)** | AkShare, East Money | ⚡ Data only |
-| **Forex** | Finnhub, OANDA | ✅ Via broker API |
+| **Forex** | Finnhub, OANDA | ✅ Via MT5 🆕 |
 | **Futures** | Exchange APIs, AkShare | ⚡ Data only |
 
 ---

README_CN.md

@@ -97,6 +97,7 @@ QuantDinger 包含一个内置的**基于 LLM 的多智能体研究系统**，
 ### 开发指南
 - [Python 策略开发指南](docs/STRATEGY_DEV_GUIDE_CN.md)
 - [盈透证券 (IBKR) 实盘交易指南](docs/IBKR_TRADING_GUIDE_CN.md) 🆕
+- [MetaTrader 5 (MT5) 外汇实盘交易指南](docs/MT5_TRADING_GUIDE_CN.md) 🆕
 
 ### 通知配置
 - [Telegram 通知配置](docs/NOTIFICATION_TELEGRAM_CONFIG_CH.md)
@@ -165,8 +166,11 @@ QuantDinger 包含一个内置的**基于 LLM 的多智能体研究系统**，
 2.  **策略配置**：附加风险管理规则（仓位管理、止损、止盈）。
 3.  **回测 & AI 优化**：运行回测，查看丰富的性能指标，并**让 AI 分析结果以建议改进**（例如：“调整 MACD 阈值为 X”）。
 4.  **执行模式**：
-    - **实盘交易**：直接 API 执行，支持 10+ 加密货币交易所（Binance, OKX 等）。
-    - **信号通知**：针对非实盘执行的市场（股票/外汇/期货），通过 Telegram, Discord, Email, SMS 或 Webhook 发送信号。
+    - **实盘交易**：
+      - **加密货币**：直接 API 执行，支持 10+ 交易所（Binance, OKX, Bitget, Bybit 等）
+      - **美股/港股**：通过盈透证券 (IBKR) 🆕
+      - **外汇**：通过 MetaTrader 5 (MT5) 🆕
+    - **信号通知**：针对不支持实盘交易的市场（A股/期货），通过 Telegram, Discord, Email, SMS 或 Webhook 发送信号。
 
 ### 3. AI 多智能体投研
 *你的 7x24 小时 AI 投委会。*
@@ -330,19 +334,32 @@ score = w_{sim}\cdot sim + w_{recency}\cdot recency + w_{returns}\cdot returns\_
 
 ---
 
-## 🔌 支持的交易所
+## 🔌 支持的交易所和券商
 
-QuantDinger 支持直接 API 连接到主要加密货币交易所进行执行，并使用 CCXT 获取广泛的行情数据。
+QuantDinger 支持多种市场类型的执行方式：
 
-### 直接 API 支持
+### 加密货币交易所（直接 API）
 
 | 交易所 | 市场 |
 |:--------:|:---------|
 | Binance | 现货, 合约, 杠杆 |
 | OKX | 现货, 永续, 期权 |
 | Bitget | 现货, 合约, 跟单交易 |
+| Bybit | 现货, 线性合约 |
+| Coinbase Exchange | 现货 |
+| Kraken | 现货, 合约 |
+| KuCoin | 现货, 合约 |
+| Gate.io | 现货, 合约 |
+| Bitfinex | 现货, 衍生品 |
 
-### 也支持通过 CCXT
+### 传统券商
+
+| 券商 | 市场 | 平台 |
+|:------:|:--------|:---------|
+| **盈透证券 (IBKR)** | 美股, 港股 | TWS / IB Gateway 🆕 |
+| **MetaTrader 5 (MT5)** | 外汇 | MT5 终端 🆕 |
+
+### 行情数据（通过 CCXT）
 
 Bybit、Gate.io、Kraken、KuCoin、HTX 以及 100+ 其他交易所用于行情数据。
 
@@ -378,7 +395,7 @@ QuantDinger 为全球用户构建，提供全面的国际化支持：
 | **美股** | Yahoo Finance, Finnhub, Tiingo | ✅ 通过盈透证券 🆕 |
 | **港股** | AkShare, 东方财富 | ✅ 通过盈透证券 🆕 |
 | **A股** | AkShare, 东方财富 | ⚡ 仅数据 |
-| **外汇** | Finnhub, OANDA | ✅ 通过券商 API |
+| **外汇** | Finnhub, OANDA | ✅ 通过 MT5 🆕 |
 | **期货** | 交易所 API, AkShare | ⚡ 仅数据 |
 
 ---

README_JA.md

@@ -97,6 +97,7 @@ QuantDingerには、ウェブから金融情報を収集し、ローカル市場
 ### 開発ガイド
 - [Python 戦略開発ガイド](docs/STRATEGY_DEV_GUIDE_JA.md)
 - [Interactive Brokers (IBKR) トレーディングガイド](docs/IBKR_TRADING_GUIDE_EN.md) 🆕
+- [MetaTrader 5 (MT5) トレーディングガイド](docs/MT5_TRADING_GUIDE_EN.md) 🆕
 
 ### 通知設定
 - [Telegram 通知設定](docs/NOTIFICATION_TELEGRAM_CONFIG_EN.md)
@@ -165,8 +166,11 @@ QuantDingerには、ウェブから金融情報を収集し、ローカル市場
 2.  **戦略設定**: リスク管理ルール（ポジションサイジング、ストップロス、利益確定）を追加。
 3.  **バックテスト & AI最適化**: バックテストを実行し、豊富なパフォーマンス指標を表示し、**AIに結果を分析させて改善を提案**させます（例：「MACD閾値をXに調整」）。
 4.  **実行モード**:
-    - **実取引**: 直接API実行、10以上の暗号資産取引所（Binance, OKXなど）をサポート。
-    - **シグナル通知**: 実取引を実行しない市場（株式/FX/先物）向けに、Telegram, Discord, Email, SMS, Webhook経由でシグナルを送信。
+    - **実取引**:
+      - **暗号資産**: 直接API実行、10以上の取引所（Binance, OKX, Bitget, Bybitなど）をサポート
+      - **米国/香港株式**: Interactive Brokers (IBKR)経由 🆕
+      - **外国為替**: MetaTrader 5 (MT5)経由 🆕
+    - **シグナル通知**: 実取引をサポートしていない市場（A株/先物）向けに、Telegram, Discord, Email, SMS, Webhook経由でシグナルを送信。
 
 ### 3. AI マルチエージェントリサーチ
 *あなたの24時間365日稼働するAI投資委員会。*
@@ -300,19 +304,32 @@ score = w_{sim}\cdot sim + w_{recency}\cdot recency + w_{returns}\cdot returns\_
 
 ---
 
-## 🔌 対応取引所
+## 🔌 対応取引所とブローカー
 
-QuantDingerは実行のための主要な暗号資産取引所への直接API接続をサポートし、広範な市場データカバレッジのためにCCXTを使用します。
+QuantDingerは複数の市場タイプに対して複数の実行方法をサポートしています：
 
-### 直接APIサポート
+### 暗号資産取引所（直接API）
 
 | 取引所 | 市場 |
 |:--------:|:---------|
 | Binance | 現物, 先物, マージン |
 | OKX | 現物, 無期限, オプション |
 | Bitget | 現物, 先物, コピートレーディング |
+| Bybit | 現物, リニア先物 |
+| Coinbase Exchange | 現物 |
+| Kraken | 現物, 先物 |
+| KuCoin | 現物, 先物 |
+| Gate.io | 現物, 先物 |
+| Bitfinex | 現物, デリバティブ |
 
-### CCXT経由でもサポート
+### 伝統的なブローカー
+
+| ブローカー | 市場 | プラットフォーム |
+|:------:|:--------|:---------|
+| **Interactive Brokers (IBKR)** | 米国株式, 香港株式 | TWS / IB Gateway 🆕 |
+| **MetaTrader 5 (MT5)** | 外国為替 | MT5ターミナル 🆕 |
+
+### 市場データ（CCXT経由）
 
 Bybit、Gate.io、Kraken、KuCoin、HTX、および100以上のその他の取引所が市場データ用にサポートされています。
 
@@ -334,7 +351,7 @@ QuantDingerは、包括的な国際化対応により、世界中のユーザー
 | **米国株** | Yahoo Finance, Finnhub, Tiingo | ✅ IBKR経由 🆕 |
 | **香港株** | AkShare, East Money | ✅ IBKR経由 🆕 |
 | **中国株(A株)** | AkShare, East Money | ⚡ データのみ |
-| **FX** | Finnhub, OANDA | ✅ ブローカーAPI経由 |
+| **FX** | Finnhub, OANDA | ✅ MT5経由 🆕 |
 | **先物** | 取引所API, AkShare | ⚡ データのみ |
 
 ---

README_KO.md

@@ -97,6 +97,7 @@ QuantDinger는 웹에서 금융 정보를 수집하고, 로컬 시장 데이터
 ### 개발 가이드
 - [Python 전략 개발 가이드](docs/STRATEGY_DEV_GUIDE_KO.md)
 - [Interactive Brokers (IBKR) 트레이딩 가이드](docs/IBKR_TRADING_GUIDE_EN.md) 🆕
+- [MetaTrader 5 (MT5) 트레이딩 가이드](docs/MT5_TRADING_GUIDE_EN.md) 🆕
 
 ### 알림 설정
 - [Telegram 알림 설정](docs/NOTIFICATION_TELEGRAM_CONFIG_EN.md)
@@ -165,8 +166,11 @@ QuantDinger는 웹에서 금융 정보를 수집하고, 로컬 시장 데이터
 2.  **전략 설정**: 위험 관리 규칙(포지션 사이징, 손절매, 이익실현)을 추가하세요.
 3.  **백테스트 & AI 최적화**: 백테스트를 실행하고, 풍부한 성과 지표를 확인하며, **AI가 결과를 분석하여 개선 사항을 제안**하도록 하세요(예: "MACD 임계값을 X로 조정").
 4.  **실행 모드**:
-    - **실거래**: 직접 API 실행, 10개 이상의 암호화폐 거래소(Binance, OKX 등) 지원.
-    - **신호 알림**: 실거래를 실행하지 않는 시장(주식/외환/선물)의 경우, Telegram, Discord, Email, SMS 또는 Webhook을 통해 신호를 전송하세요.
+    - **실거래**:
+      - **암호화폐**: 직접 API 실행, 10개 이상의 거래소(Binance, OKX, Bitget, Bybit 등) 지원
+      - **미국/홍콩 주식**: Interactive Brokers (IBKR) 경유 🆕
+      - **외환**: MetaTrader 5 (MT5) 경유 🆕
+    - **신호 알림**: 실거래를 지원하지 않는 시장(A주/선물)의 경우, Telegram, Discord, Email, SMS 또는 Webhook을 통해 신호를 전송하세요.
 
 ### 3. AI 멀티 에이전트 리서치
 *연중무휴 24시간 AI 투자 위원회.*
@@ -300,19 +304,32 @@ score = w_{sim}\cdot sim + w_{recency}\cdot recency + w_{returns}\cdot returns\_
 
 ---
 
-## 🔌 지원되는 거래소
+## 🔌 지원되는 거래소 및 브로커
 
-QuantDinger는 실행을 위한 주요 암호화폐 거래소에 대한 직접 API 연결을 지원하며, 광범위한 시장 데이터 커버리지를 위해 CCXT를 사용합니다.
+QuantDinger는 다양한 시장 유형에 대해 여러 실행 방법을 지원합니다:
 
-### 직접 API 지원
+### 암호화폐 거래소(직접 API)
 
 | 거래소 | 시장 |
 |:--------:|:---------|
 | Binance | 현물, 선물, 마진 |
 | OKX | 현물, 무기한, 옵션 |
 | Bitget | 현물, 선물, 카피 트레이딩 |
+| Bybit | 현물, 선형 선물 |
+| Coinbase Exchange | 현물 |
+| Kraken | 현물, 선물 |
+| KuCoin | 현물, 선물 |
+| Gate.io | 현물, 선물 |
+| Bitfinex | 현물, 파생상품 |
 
-### CCXT를 통해서도 지원
+### 전통적인 브로커
+
+| 브로커 | 시장 | 플랫폼 |
+|:------:|:--------|:---------|
+| **Interactive Brokers (IBKR)** | 미국 주식, 홍콩 주식 | TWS / IB Gateway 🆕 |
+| **MetaTrader 5 (MT5)** | 외환 | MT5 터미널 🆕 |
+
+### 시장 데이터(CCXT 경유)
 
 Bybit, Gate.io, Kraken, KuCoin, HTX 및 100개 이상의 기타 거래소가 시장 데이터용으로 지원됩니다.
 
@@ -347,7 +364,7 @@ QuantDinger는 포괄적인 국제화를 통해 글로벌 사용자를 위해 
 | **미국 주식** | Yahoo Finance, Finnhub, Tiingo | ✅ IBKR 경유 🆕 |
 | **홍콩 주식** | AkShare, East Money | ✅ IBKR 경유 🆕 |
 | **중국 주식(A주)** | AkShare, East Money | ⚡ 데이터만 |
-| **외환** | Finnhub, OANDA | ✅ 브로커 API 경유 |
+| **외환** | Finnhub, OANDA | ✅ MT5 경유 🆕 |
 | **선물** | 거래소 API, AkShare | ⚡ 데이터만 |
 
 ---

README_TW.md

@@ -97,6 +97,7 @@ QuantDinger 包含一個內置的**基於 LLM 的多智能體研究系統**，
 ### 開發指南
 - [Python 策略開發指南](docs/STRATEGY_DEV_GUIDE_TW.md)
 - [盈透證券 (IBKR) 實盤交易指南](docs/IBKR_TRADING_GUIDE_CN.md) 🆕
+- [MetaTrader 5 (MT5) 外匯實盤交易指南](docs/MT5_TRADING_GUIDE_CN.md) 🆕
 
 ### 通知配置
 - [Telegram 通知配置](docs/NOTIFICATION_TELEGRAM_CONFIG_CH.md)
@@ -165,8 +166,11 @@ QuantDinger 包含一個內置的**基於 LLM 的多智能體研究系統**，
 2.  **策略配置**：附加風險管理規則（倉位管理、止損、止盈）。
 3.  **回測 & AI 優化**：運行回測，查看豐富的性能指標，並**讓 AI 分析結果以建議改進**（例如：「調整 MACD 閾值為 X」）。
 4.  **執行模式**：
-    - **實盤交易**：直接 API 執行，支持 10+ 加密貨幣交易所（Binance, OKX 等）。
-    - **信號通知**：針對非實盤執行的市場（股票/外匯/期貨），通過 Telegram, Discord, Email, SMS 或 Webhook 發送信號。
+    - **實盤交易**：
+      - **加密貨幣**：直接 API 執行，支持 10+ 交易所（Binance, OKX, Bitget, Bybit 等）
+      - **美股/港股**：通過盈透證券 (IBKR) 🆕
+      - **外匯**：通過 MetaTrader 5 (MT5) 🆕
+    - **信號通知**：針對不支持實盤交易的市場（A股/期貨），通過 Telegram, Discord, Email, SMS 或 Webhook 發送信號。
 
 ### 3. AI 多智能體投研
 *你的 7x24 小時 AI 投委會。*
@@ -300,19 +304,32 @@ score = w_{sim}\cdot sim + w_{recency}\cdot recency + w_{returns}\cdot returns\_
 
 ---
 
-## 🔌 支持的交易所
+## 🔌 支持的交易所和券商
 
-QuantDinger 支持直接 API 連接到主要加密貨幣交易所進行執行，並使用 CCXT 獲取廣泛的行情數據。
+QuantDinger 支持多種市場類型的執行方式：
 
-### 直接 API 支持
+### 加密貨幣交易所（直接 API）
 
 | 交易所 | 市場 |
 |:--------:|:---------|
 | Binance | 現貨, 合約, 槓桿 |
 | OKX | 現貨, 永續, 期權 |
 | Bitget | 現貨, 合約, 跟單交易 |
+| Bybit | 現貨, 線性合約 |
+| Coinbase Exchange | 現貨 |
+| Kraken | 現貨, 合約 |
+| KuCoin | 現貨, 合約 |
+| Gate.io | 現貨, 合約 |
+| Bitfinex | 現貨, 衍生品 |
 
-### 也支持通過 CCXT
+### 傳統券商
+
+| 券商 | 市場 | 平台 |
+|:------:|:--------|:---------|
+| **盈透證券 (IBKR)** | 美股, 港股 | TWS / IB Gateway 🆕 |
+| **MetaTrader 5 (MT5)** | 外匯 | MT5 終端 🆕 |
+
+### 行情數據（通過 CCXT）
 
 Bybit、Gate.io、Kraken、KuCoin、HTX 以及 100+ 其他交易所用於行情數據。
 
@@ -348,7 +365,7 @@ QuantDinger 為全球用戶構建，提供全面的國際化支持：
 | **美股** | Yahoo Finance, Finnhub, Tiingo | ✅ 通過盈透證券 🆕 |
 | **港股** | AkShare, 東方財富 | ✅ 通過盈透證券 🆕 |
 | **A股** | AkShare, 東方財富 | ⚡ 僅數據 |
-| **外匯** | Finnhub, OANDA | ✅ 通過券商 API |
+| **外匯** | Finnhub, OANDA | ✅ 通過 MT5 🆕 |
 | **期貨** | 交易所 API, AkShare | ⚡ 僅數據 |
 
 ---

backend_api_python/app/routes/__init__.py

@@ -1,11 +1,11 @@
 """
-API 路由模块
+API Routes Module
 """
 from flask import Flask
 
 
 def register_routes(app: Flask):
-    """注册所有 API 路由蓝图"""
+    """Register all API route blueprints"""
     from app.routes.kline import kline_bp
     from app.routes.analysis import analysis_bp
     from app.routes.backtest import backtest_bp
@@ -20,9 +20,10 @@ def register_routes(app: Flask):
     from app.routes.settings import settings_bp
     from app.routes.portfolio import portfolio_bp
     from app.routes.ibkr import ibkr_bp
+    from app.routes.mt5 import mt5_bp
 
     app.register_blueprint(health_bp)
-    app.register_blueprint(auth_bp, url_prefix='/api/user')  # 兼容前端 /api/user/login
+    app.register_blueprint(auth_bp, url_prefix='/api/user')
     app.register_blueprint(kline_bp, url_prefix='/api/indicator')
     app.register_blueprint(analysis_bp, url_prefix='/api/analysis')
     app.register_blueprint(backtest_bp, url_prefix='/api/indicator')
@@ -35,4 +36,5 @@ def register_routes(app: Flask):
     app.register_blueprint(settings_bp, url_prefix='/api/settings')
     app.register_blueprint(portfolio_bp, url_prefix='/api/portfolio')
     app.register_blueprint(ibkr_bp, url_prefix='/api/ibkr')
+    app.register_blueprint(mt5_bp, url_prefix='/api/mt5')