Haven MT5 to Telegram
- 实用工具
-
Maksim Tarutin
🔷 MQL5 Developer | Haven
------------------------------------------------------------
I develop trading tools for MetaTrader 5, including indicators, utilities, and Expert Advisors.
My main areas of interest are market structure, liquidity, price action, volatility, and systematic trading. - 版本: 20.0
- 更新: 28 九月 2026
- 激活: 10
Haven MT5 to Telegram 2.0 — 将 MT5 交易发布到 Telegram
Haven MT5 to Telegram 是一款用于将 MetaTrader 5 交易事件自动发布到 Telegram 的工具。
它可以跟踪持仓的开仓和平仓、止损和止盈修改、部分平仓以及挂单事件。消息还可以包含图表截图、Trade ID 和交易结果。
Haven MT5 to Telegram 2.0 新功能
2.0 版本带来了全新的界面，并重新设计了交易事件发布系统。
-
SIMPLE 模式
主要设置集中在一个界面中。您可以在这里检查 Telegram 连接状态，启用或禁用主要通知类型、 截图，并选择首次交易信号的发布时间方式。 -
ADVANCED 模式
高级界面包含发布、样式、报告和诊断等独立部分。SIMPLE 和 ADVANCED 使用相同的 设置。 -
完整交易生命周期
Haven 可以发布市场入场、SL/TP 修改、Break Even、部分平仓、全部平仓以及主要挂单 事件。 -
首次消息前等待 SL
新入场交易可使用 Immediately、Fixed Delay 或 Wait for SL 模式。这样 Haven 可以等待保护性 止损设置完成，并在第一条消息中同时发送 Entry、SL 和 TP。等待时间始终受可配置的最大超时限制。 -
STANDARD 和 CUSTOM TEMPLATES
STANDARD 提供开箱即用的消息格式。CUSTOM TEMPLATES 允许您使用自己的 HTML 模板或 TXT 文件来定义 Pending、Open 和 Close 消息。
交易通知
Haven 直接监控 MT5 中的交易事件，并根据当前设置生成消息。
- Market Entry — 新持仓开仓。
- SL / TP Change — 修改 Stop Loss 或 Take Profit。
- Break Even — 将保护性止损移动到入场价格附近。
- Partial Close — 部分平仓。
- Full Close — 完全平仓。
- Pending Created — 创建挂单。
- Pending Modified — 修改挂单参数。
- Pending Activated — 挂单被触发。
- Pending Cancelled / Expired — 挂单被取消或到期。
交易事件使用稳定的 Trade ID，有助于区分同一交易品种上的不同交易。
STANDARD 消息
在 STANDARD 模式下，用户无需编辑 HTML。Haven 会自动生成消息结构。
您可以选择显示以下字段：
- Symbol
- Direction
- Entry / Exit
- Stop Loss
- Take Profit
- Trade ID
- Duration
- Close Reason
- Volume
- Money P/L
- Ticket
如果不希望公开这些信息，可以关闭 Volume、Money P/L 和 Ticket 等可选字段。
图表截图
Haven 可以自动将图表截图附加到支持的交易消息中。
-
自动画面调整
创建截图前，Haven 会根据事件时间和交易价格水平调整图表比例和可见区域。 -
交易价格水平
截图中可以显示 Entry、Exit、Stop Loss 和 Take Profit。对于已关闭的交易，还可以显示 入场价格与出场价格之间的实际区间。 -
Watermark
您可以在截图上添加文字水印或 @username。可以设置文本、大小和位置。颜色会根据 图表背景自动选择。 -
隐藏面板
截图期间可以临时隐藏 Haven 面板，截图完成后自动恢复。
交易报告和当前持仓
Haven 提供独立的报告功能。
- Daily Trading Report — 每日报告，可手动发送，也可根据经纪商服务器时间自动发送。
- Weekly Trading Report — 从本周开始时间计算的手动周报。
- Open Positions — 发送当前所有符合条件的持仓列表。
V2 报告按照完整结束的交易段进行统计。部分平仓会计入相应交易的最终结果，不会单独增加 Trades 数量。
报告可以包括：
- Trades
- Wins / Losses / Breakeven
- Win Rate
- Gross P/L
- Trading Costs
- Net P/L
Trading Costs 包括 MT5 历史记录中可获得的佣金、费用和 swap。
技术功能
| Multi-Symbol | 工具可以只运行在一个图表上，同时监控账户中的所有交易品种。如有需要，也可以限制为仅监控当前图表品种。 |
| Magic Filter | 您可以监控全部交易，也可以只发布指定 Magic Number 的交易。 |
| Persistent Queue | 消息通过持久化发送队列进行处理。MT5 重启后，队列状态以及已确认的 Telegram 消息状态都会恢复。 |
| Retry | 如果发生临时连接错误，Haven 会保留发送任务，并根据内部队列逻辑自动重试。 |
| Telegram Diagnostics | 面板会显示 Telegram、Bot、Destination、发送队列以及发送错误的状态。 |
| Test Message | 您可以检查 Telegram 连接，也可以在不开启真实交易的情况下单独发送测试交易消息。 |
| Economic Calendar | 还可以启用来自 MT5 Economic Calendar 的高影响经济事件 Telegram 通知。 |
| No DLL | 工具运行不需要任何外部 DLL。 |
SIMPLE 界面
SIMPLE 模式用于快速设置。Telegram 状态和主要发布设置集中显示在一个界面中：
- Market Entry
- Trade Close
- SL / TP Updates
- Pending Orders
- Screenshots
- Initial Signal
如果不需要额外配置，连接 Telegram 后可以保留默认设置并直接开始使用。
ADVANCED 界面
ADVANCED 模式提供完整的 Haven 设置界面：
- Overview — 连接和队列状态。
- Publish — 交易通知类型、消息格式和 Initial Signal 设置。
- Style — 截图和 Watermark 设置。
- Reports — Daily / Weekly Reports、Open Positions 和 Economic Calendar 通知。
- System — Telegram 和发送系统诊断。
连接 Telegram
步骤 1：创建 Telegram Bot
- 打开 Telegram，并找到官方 BotFather 机器人。
- 使用 /newbot 命令创建新的机器人。
- 设置名称和 username。
- BotFather 会提供一个 Bot Token。请保存它。
步骤 2：准备接收目标
Haven 可以向您的 Telegram Bot 有权限访问的个人聊天、群组或频道发送消息。
如果使用频道，请将机器人添加为管理员并授予发送消息权限，然后获取相应的 Chat ID。
步骤 3：配置 MT5
- 打开 Tools -> Options -> Expert Advisors。
- 启用 Allow WebRequest for listed URL。
- 添加 Telegram API 地址：https://api.telegram.org
- 点击 OK。
步骤 4：启动 Haven
- 将 Haven MT5 to Telegram 添加到任意图表。
- 按 F7，并输入您的 Bot Token 和 Chat ID。
- 应用设置。
- 在 SIMPLE 面板中点击 VERIFY TELEGRAM。
- 验证成功后，状态会变为 READY。
- 如有需要，点击 SEND TEST 检查消息是否能够正常发送。
当状态显示 READY 后，Haven 就可以开始监控所选交易事件，并将它们发布到已配置的 Telegram 目标。
