# MT4 智能交易桥 · 量化自动交易系统

MT4 智能交易桥。通过文件 I/O 与 MT4 EA 通信，无需 DLL 或额外依赖。支持 OpenClaw（小龙虾 AI Agent）通过微信 / 飞书 / Telegram 等渠道直接操作 MT4 交易。

> 关键词：MT4, MetaTrader 4, 外汇交易, Python交易, 算法交易, 自动交易, 网格策略, 支撑压力位, ATR止损, 移动止损, 黄金交易, 原油交易, 比特币交易, OpenClaw, 小龙虾, AI交易助手, 微信操作MT4, 飞书操作MT4

🎯 自然语言交互示例

📱 微信/飞书/Telegram 口语化命令

| 你说 | MT4 做 |

|-----|--------|

| 黄金多少钱 | 返回 XAUUSD.s 实时报价 |

| 买黄金 0.05 手 | 市价买入 0.05 手 |

| 平仓 95832104 | 平掉指定订单 |

| 全平 | 平掉所有持仓 |

| 查持仓 | 列出当前所有持仓 |

| 设置止损 95832104 4500 | 设置止损位 |

| 启动黄金网格 | 启动黄金网格策略 |

| 获取MT4 黄金的1小时K线数据进行行情分析 | 将会自动帮您分析好黄金后市走向以及给出交易方案 |

文件结构

mt4-trader/
├── SKILL.md                         # 本使用说明
├── mql4/                            # MT4 EA 编译文件（.ex4，由脚本生成）
│   [用户手动下载 .ex4 文件放到此目录]
├── scripts/                         # Python 脚本
│   ├── mt4_client.py                # Python 交易客户端（核心）
│   ├── deploy_ex4.py                # EA 部署指引（显示下载链接和安装步骤）
│   ├── alert_commands.py            # 价格预警命令行工具
│   ├── position_summary.py          # 持仓汇总（命令行输出）
│   ├── position_summary_cron.py     # 持仓汇总（定时推送）
│   ├── sr_strategy.py               # 支撑压力位策略编排
│   └── summary_utils.py             # 持仓汇总工具模块
└── references/
    └── api_docs.md                  # 完整 API 参考文档

安装步骤（详细版）

第一步：找到你的 MT4 数据目录

每个 MT4 安装实例都有一个专属的数据目录，格式为：

%APPDATA%\MetaQuotes\Terminal\<32位随机ID>

例如：C:\Users\Administrator\AppData\Roaming\MetaQuotes\Terminal\ABC123...

> 怎么找？在 MT4 中按 F7 打开 MetaEditor（代码编辑器），点击菜单 文件 → 打开数据文件夹，弹出的路径就是你的 MT4 数据目录。

第二步：确认 MT4 安装目录

EA 文件需要部署到两个不同的目录：

| EA 文件 | 目标目录 | 说明 |

|---------|---------|------|

| mt4_bridge.ex4 | MT4安装目录\MQL4\Experts\ | 主程序 EA（必须） |

| 芝麻网格V2.ex4 | MT4安装目录\MQL4\Experts\ | 网格策略 EA（可选） |

| tools2.3.ex4 | MT4安装目录\MQL4\Libraries\ | 网格策略依赖库（网格必须，不是 Experts！） |

> ⚠️ Libraries 目录与 Experts、Indicators 同级，不是 Experts 的子目录。

典型路径结构：

C:\Program Files (x86)\EBC Financial Group Cayman MT4 Terminal\MQL4\
├── Experts\           ← mt4_bridge.ex4, 芝麻网格V2.ex4 放这里
│   ├── mt4_bridge.ex4
│   └── 芝麻网格V2.ex4
├── Libraries\         ← tools2.3.ex4 放这里（与 Experts 同级！）
│   └── tools2.3.ex4
├── Indicators\
└── Scripts\

第三步：下载 .ex4 文件

从 Gitee 仓库下载 3 个 .ex4 文件：

https://gitee.com/3603317/skill-plugin/tree/master/mt4

需要下载的文件：

| 文件 | 说明 |

|------|------|

| mt4_bridge.ex4 | 主程序 EA（必选） |

| 芝麻网格V2.ex4 | 网格策略 EA（可选） |

| tools2.3.ex4 | 网格策略依赖库（选网格则必选） |

> 点击文件 → 点右上角 Raw 按钮即可保存到本地。

下载后放入 skills\mt4-trader\mql4\ 目录，然后运行以下命令一键部署到 MT4：

cd scripts\
python deploy_ex4.py deploy

第四步：在 MT4 中挂载 EA

挂载 mt4_bridge（核心，必须操作）：

打开 MT4，按 Ctrl+N 打开左侧"导航器"面板
展开"EA 交易"列表，找到 mt4_bridge
用鼠标左键拖拽到任意品种图表上（推荐 XAUUSD.s 或主流品种）
弹出 EA 属性对话框 → 选项卡"常用"：

允许实时交易 → ✅ 勾选（必须！）
允许导入 DLL → ✅ 勾选
确认取消"手动交易禁止" 等限制

点"确定"关闭对话框
图表右上角显示一个 EA 图标：

😊 绿色笑脸 → ✅ 正常工作中
😢 哭脸或灰脸 → 检查下面"第五步"的自动交易按钮

右键图表 → 属性 → 常用 中可修改 EA 输入参数（可选）

可选：挂载芝麻网格 EA：

将 芝麻网格V2 EA 拖到需要跑网格的品种图表上（如 XAUUSD.s、XTIUSD.s）
勾选"允许实时交易"
确认 tools2.3.ex4 已放在 Libraries\ 目录中，否则网格 EA 无法运行

多图表挂载（重要）：

mt4_bridge EA 可以挂载在多个品种的图表上（例如黄金一个图表、原油一个图表）
每个 EA 实例自动通过品种专属请求文件区分，不会互相干扰
Python 客户端传了 symbol 参数后，会自动路由到对应的品种请求文件

第五步：开启自动交易

这是新手最容易忽略的一步！

在 MT4 工具栏上方找到 "自动交易"按钮（一个黄色播放 ▶️ 图标）
如果它是灰色的 → 点击一下，变成绿色 ✅
此时所有已挂载的 EA 图标都应变成 绿色笑脸 😊
如果某个 EA 还是哭脸，右键该 EA 图标 → "属性" → 勾选"允许实时交易"

> 💡 每次重启 MT4 后，自动交易按钮默认为关闭状态，需要手动开启。

> 建议在 MT4 设置中勾选"启动时启用自动交易"。

第六步：验证部署是否成功

方法一：脚本检查

cd scripts\
python mt4_client.py

如果看到类似下面的交互菜单，说明通信正常：

=== MT4 交易助手 ===
1. 获取报价  2. 查询持仓  3. 交易  4. 网格策略
请输入指令：

方法二：Python 代码验证

from mt4_client import MT4Client
client = MT4Client()

# 获取账户信息（确认通信正常）
info = client.get_account_info()
print(info)  # 应该看到余额、净值、可用保证金

# 获取实时报价
price = client.get_price("XAUUSD.s")
print(price) # 应该看到 bid/ask 价格

如果返回 "MT4 超时未响应"：

MT4 在运行吗？→ 打开 MT4
EA 挂载了吗？→ 图表上有没有 EA 图标
自动交易开了吗？→ 工具栏自动交易按钮是绿色吗
EA 属性中"允许实时交易"勾了吗？→ 右键 EA 图标检查

核心 Python 方法

from mt4_client import MT4Client
client = MT4Client()

# === 行情 ===
client.get_price("XAUUSD.s")             # 获取实时报价（bid/ask）
client.get_positions()                    # 查询持仓列表
client.get_account_info()                 # 账户余额/净值/保证金
client.get_history(7)                     # 历史订单（最近 7 天）

# === 交易 ===
client.buy(symbol="XAUUSD.s", lots=0.03)  # 市价买入 0.03 手
client.sell(symbol="XAUUSD.s", lots=0.03) # 市价卖出 0.03 手
client.close(ticket=123456)               # 平指定订单
client.close_all()                        # 一键全平
client.partial_close(ticket=123456, lots=0.02) # 部分平仓

# === 止损止盈 ===
client.set_sl(ticket=123456, sl=75000)          # 设置止损
client.set_tp(ticket=123456, tp=80000)          # 设置止盈
client.modify_order(ticket=123456, sl=75000, tp=80000) # 同时修改
client.auto_sl(ticket=123456, risk_percent=2.0) # 按账户 2% 风险自动止损
client.atr_sl(ticket=123456, period=14, multiplier=2.0) # ATR 止损
client.trailing_stop(ticket=123456, distance=300) # 移动止损（300 点间距）

# === 平所有多单/空单 ===
client.close_all_buy()                     # 平所有多单
client.close_all_sell()                    # 平所有空单
client.close_profit()                      # 平所有盈利单
client.close_loss()                        # 平所有亏损单

# === 挂单 ===
client.buy_limit(symbol="XAUUSD.s", lots=0.03, price=4500.0)  # 限价买入
client.sell_limit(symbol="XAUUSD.s", lots=0.03, price=4600.0) # 限价卖出
client.buy_stop(symbol="XAUUSD.s", lots=0.03, price=4700.0)   # 买入止损（突破追涨）
client.sell_stop(symbol="XAUUSD.s", lots=0.03, price=4500.0)  # 卖出止损（破位追空）
client.get_pending_orders()                # 查询当前挂单
client.cancel_pending(ticket=123456)       # 取消挂单

# === OCO 订单（二选一挂单） ===
client.oco_order(symbol="XAUUSD.s", lots=0.03,
    order1={"type": "buy_stop",  "price": 77000, "sl": 76500},
    order2={"type": "sell_stop", "price": 76000, "sl": 76500}
)

# === 手数计算 ===
client.calc_lots(symbol="XAUUSD.s", risk_percent=1.0, sl_distance=5.0)
# 1% 风险，止损 5 美元 → 返回建议手数

# === K 线数据（量化分析用） ===
client.get_klines(symbol="XAUUSD.s", timeframe="H1", count=20)   # H1 最近 20 根
client.get_klines(symbol="XAUUSD.s", timeframe="M15", count=100) # M15 最近 100 根
client.get_klines(symbol="XAUUSD.s", timeframe="D1", count=30)   # 最近 30 根日线

# === 支撑压力位 ===
client.get_sr_levels(symbol="XAUUSD.s")      # 获取支撑压力位
client.draw_sr_levels(symbol="XAUUSD.s")     # 在图表上画出支撑压力位线
client.clear_chart_objects(symbol="XAUUSD.s")  # 清除图表上所有对象
client.draw_hline(symbol="XAUUSD.s", name="R1", price=4750)  # 画自定义水平线
client.clear_hline(symbol="XAUUSD.s", prefix="HL_")  # 按前缀删除水平线

> ⚠️ 重要：使用关键字参数！

> 所有交易方法（buy/sell/close/set_sl 等）必须使用关键字参数传参：

> ```python

> # ✅ 正确

> client.buy(symbol="XAUUSD.s", lots=0.03)

> client.set_sl(ticket=123456, sl=75000)

> # ❌ 错误——按位置传参可能会导致 order 4106（交易被禁用）

> client.buy(0.03, "XAUUSD.s") # 顺序可能不对！

> ```

网格策略（芝麻网格 EA）

| 命令 | 说明 |

|------|------|

| client.grid_start(symbol="XAUUSD.s") | 启动网格 |

| client.grid_stop(symbol="XAUUSD.s") | 停止网格（不再开新单） |

| client.grid_close_all(symbol="XAUUSD.s") | 平掉所有网格持仓单 |

| client.grid_status(symbol="XAUUSD.s") | 查询网格运行状态 |

| client.grid_set_sl_tp(symbol="XAUUSD.s") | 批量设置网格单的止损止盈 |

> ⚠️ 平网格仓必须按以下顺序分两步执行：

> ```python

> client.grid_stop(symbol="XAUUSD.s") # 第一步：停止网格

> client.grid_close_all(symbol="XAUUSD.s") # 第二步：平掉所有网格单

> ```

> 不可直接用 close_all() 平网格单。close_all 命令会拒绝 magic=777777（网格单）。

> 网格单必须走芝麻网格 EA 自己的关闭通道。

价格预警（可选）

cd scripts\

python alert_commands.py profit 20        # 总盈利达到 $20 时提醒
python alert_commands.py above 77000      # BTC 突破 77000 时提醒
python alert_commands.py below 75000      # BTC 跌破 75000 时提醒
python alert_commands.py list             # 查看当前所有预警
python alert_commands.py clear            # 清除所有预警
python alert_commands.py cancel 3        # 取消第 3 号预警

品种代码

| 品种 | 代码 | 说明 |

|------|------|------|

| 黄金 | XAUUSD.s | XAUUSD 后缀 .s 是部分经纪商标准 |

| 比特币 | BTCUSD | 部分平台为 BTCUSD.pro |

| 原油 | XTIUSD.s | 美国原油（WTI） |

| 白银 | XAGUSD.s | 现货白银 |

> 品种代码精确格式因经纪商而异。如果 get_price 找不到品种，在 MT4 市场报价中右键 → "全部显示"确认准确的品种名。

通信原理

┌──────────┐    JSON 文件     ┌──────────────┐
│  Python   │ ───request────→ │  MT4 EA      │
│  Client   │ ←──response──── │  (on chart)   │
└──────────┘    JSON 文件     └──────────────┘

共享目录：%APPDATA%\MetaQuotes\Terminal\Common\Files\mt4_bridge\
示例：C:\Users\Administrator\AppData\Roaming\MetaQuotes\Terminal\Common\Files\mt4_bridge\
请求文件：request_{品种}.json（如 request_XAUUSD.s.json）
响应文件：response_{品种}.json
协议：JSON over 文件（零 DLL 依赖）
超时：5 秒（Python 客户端默认配置）
多品种支持：多个 EA 实例通过品种专属文件名自动区分

常见问题排查

| 现象 | 可能原因 | 解决方法 |

|------|---------|---------|

| MT4 超时未响应 | EA 未挂载或自动交易未启动 | 确认图表右上角为绿色笑脸 😊 |

| error 4106（交易禁用） | EA 属性中"允许实时交易"未勾选 | 右键 EA → 属性 → 勾选"允许实时交易" |

| 找不到价格（空结果） | 品种代码不匹配 | 在 MT4 市场报价中确认精确名称 |

| tools2.3 编译报错 | 文件放错了目录 | 确认 tools2.3.ex4 在 MQL4\Libraries\，不是 Experts\ |

| 重复下单 | 多个 EA 读同一个请求文件 | 使用 v1.84+ 版本，自动使用品种专属文件 |

| BTC 无法市价交易 | 部分经纪商禁用 BTC 市价单 | 改用 buy_limit()/sell_limit() 限价单 |

| 重启 MT4 后 EA 不跑 | 自动交易默认关闭 | 手动点绿色播放按钮，或在设置中勾选"启动时启用" |

| 芝麻网格周末不运行 | 经纪商周末休市 | 正常现象，周一开市自动恢复 |

交流与反馈

欢迎加入 MT4 自动化技术交流群，一起讨论 MT4 自动交易、Python 量化、EA 开发等话题。

微信搜索：jiaoyibaohe （老码农）加我好友，备注 MT4 即可拉入群聊。

或进入gitee项目主页，查看群二维码

https://gitee.com/3603317/skill-plugin/tree/master

> 📱 扫码添加微信好友，备注 MT4 即可拉入技术交流群。

> 群内可交流：安装问题、使用技巧、功能建议、Bug 反馈。

版本信息

| 文件 | 版本 | 最后更新 |

|------|------|---------|

| mt4_bridge.ex4 | v1.86 | 2026-05 |

| 芝麻网格V2.ex4 | v1.41 | 2026-03 |

| tools2.3.ex4 | v2.3 | 2025-12 |

| mt4_client.py | v1.86 | 2026-05-05 |

| deploy_ex4.py | v1.0.7 | 2026-05-05 |

MT4 Trading Bridge · Automated Trading System

MT4 Trading Bridge communicates with MT4 EA via file I/O — zero DLLs, zero extra dependencies. Supports OpenClaw AI Agent to control MT4 trading through WeChat / Feishu / Telegram and other channels.

> Keywords: MT4, MetaTrader 4, Forex Trading, Python Trading, Algorithmic Trading, Automated Trading, Grid Strategy, Support & Resistance, ATR Stop Loss, Trailing Stop, Gold Trading, Crude Oil Trading, Bitcoin Trading, OpenClaw, AI Trading Assistant

File Structure

mt4-trader/
├── SKILL.md                         # This documentation
├── mql4/                            # MT4 EA compiled files (.ex4, generated by script)
│   [Manually download .ex4 files here]
├── scripts/                         # Python scripts
│   ├── mt4_client.py                # Python trading client (core)
│   ├── deploy_ex4.py                # EA deployment guide (shows download links & steps)
│   ├── alert_commands.py            # Price alert CLI tool
│   ├── position_summary.py          # Position summary (CLI output)
│   ├── position_summary_cron.py     # Position summary (scheduled push)
│   ├── sr_strategy.py               # Support/Resistance strategy orchestrator
│   └── summary_utils.py             # Position summary utility module
└── references/
    └── api_docs.md                  # Full API reference

Installation

Step 1: Find Your MT4 Data Directory

Each MT4 installation has a unique data directory:

%APPDATA%\MetaQuotes\Terminal\<32-char-random-ID>

> How to find it? In MT4, press F7 to open MetaEditor, then click File -> Open Data Folder.

Step 2: Confirm MT4 Directory

EA files go into two directories:

| EA File | Target Directory | Notes |

|---------|-----------------|-------|

| mt4_bridge.ex4 | MT4_Install_Dir\MQL4\Experts\ | Core EA (required) |

| SesameGridV2.ex4 | MT4_Install_Dir\MQL4\Experts\ | Grid strategy EA (optional) |

| tools2.3.ex4 | MT4_Install_Dir\MQL4\Libraries\ | Grid dependency (required if using grid) |

> Libraries is at the same level as Experts — NOT a subdirectory of Experts.

Step 3: Download .ex4 Files

From Gitee: https://gitee.com/3603317/skill-plugin/tree/master/mt4

Files: mt4_bridge.ex4 (required), SesameGridV2.ex4 (optional), tools2.3.ex4 (grid dependency).

Step 4: Attach EAs in MT4

Drag mt4_bridge onto any chart. In properties -> Common tab: check "Allow live trading" and "Allow DLL imports". Green smiley means working.

Optional: Attach SesameGridV2 on grid-trading charts.

Step 5: Enable Auto Trading

Click the yellow play icon (unicode triangle) on MT4 toolbar to turn it green.

Step 6: Verify

Run: python mt4_client.py

Core Python Methods

from mt4_client import MT4Client
client = MT4Client()

# Market Data
client.get_price("XAUUSD.s")           # Real-time quote
client.get_positions()                 # Open positions
client.get_account_info()              # Account info
client.get_history(7)                  # Order history (7 days)

# Trading
client.buy(symbol="XAUUSD.s", lots=0.03)
client.sell(symbol="XAUUSD.s", lots=0.03)
client.close(ticket=123456)
client.close_all()                     # Close all positions

# SL/TP
client.set_sl(ticket=123456, sl=75000)
client.set_tp(ticket=123456, tp=80000)
client.modify_order(ticket=123456, sl=75000, tp=80000)
client.trailing_stop(ticket=123456, distance=300)

# Pending Orders
client.buy_limit(symbol="XAUUSD.s", lots=0.03, price=4500.0)
client.sell_limit(symbol="XAUUSD.s", lots=0.03, price=4600.0)
client.buy_stop(symbol="XAUUSD.s", lots=0.03, price=4700.0)
client.sell_stop(symbol="XAUUSD.s", lots=0.03, price=4500.0)
client.get_pending_orders()
client.cancel_pending(ticket=123456)

# Kline Data
client.get_klines(symbol="XAUUSD.s", timeframe="H1", count=20)

# Support & Resistance
client.get_sr_levels(symbol="XAUUSD.s")
client.draw_sr_levels(symbol="XAUUSD.s")
client.clear_chart_objects(symbol="XAUUSD.s")  # Clear all chart objects
client.draw_hline(symbol="XAUUSD.s", name="R1", price=4750)  # Draw horizontal line
client.clear_hline(symbol="XAUUSD.s", prefix="HL_")  # Delete lines by prefix

> Use keyword arguments for all trading methods!

Grid Strategy

| Command | Description |

|---------|-------------|

| grid_start(symbol) | Start grid |

| grid_stop(symbol) | Stop grid |

| grid_close_all(symbol) | Close grid orders |

| grid_status(symbol) | Check status |

For closing grid: call grid_stop() first, then grid_close_all().

Symbol Codes

| Instrument | Code |

|------------|------|

| Gold | XAUUSD.s |

| Bitcoin | BTCUSD |

| Crude Oil | XTIUSD.s |

| Silver | XAGUSD.s |

Troubleshooting

| Issue | Solution |

|-------|----------|

| MT4 Timeout | EA not attached or auto-trading off |

| error 4106 | "Allow live trading" unchecked |

| Empty price result | Wrong symbol code |

| Duplicate orders | Use v1.84+ for symbol-specific files |

| BTC market order fails | Some brokers disable BTC market orders |

Communication & Feedback

Join the MT4 Automated Trading Technical Group to discuss MT4 auto trading, Python quantitative trading, EA development, and more.

Search WeChat: jiaoyibaohe (MT4 Developer) — add me as a friend, note MT4 to join the group.

Click to view Gitee project homepage, group QR code

> Scan the QR code to add WeChat friend, note MT4 to join the technical group.

> Topics: installation issues, usage tips, feature suggestions, bug reports.

Mt4 Trader

概述