Eagle Telegram Signal Provider
- 实用工具
- 版本: 1.4
Signal Provider
在您交易的同时，把账户的交易发布到 Telegram 聊天、群组或频道：新订单、修改、部分平仓、平仓、挂单，以及每日、每周和每月报告。每条消息显示价格水平、以金额和百分比表示的风险、交易结果，并可附带一张画有该笔交易的图表截图。无需打字：您负责交易，EA 负责写消息。
Eagle Signal Provider 跟踪账户的每一笔交易和每一个挂单，在每个事件发生后片刻发送一条清晰的 Telegram 消息。您的订阅者可以看到您做了什么、以什么价格、承担多少风险、得到什么结果，格式适合在手机上阅读。延迟、止损规则和过滤器决定发布哪些内容，因此手动交易、其他 EA 的交易或没有止损的交易不会被误发到频道。
订阅者收到的内容
- 新订单：品种、方向、入场价、SL 和 TP 及其距离、手数、以金额和余额或净值百分比表示的风险与目标、风险回报比、账户信息行和注释。
- 修改：用文字说明修改的含义：止损移至保本、锁定利润、风险降低或增加、设置或移除止损、目标扩大、缩小、设置或移除、订单移动。显示旧价格和新价格，以及修改后的风险和目标。
- 部分平仓：已平仓和剩余手数、占初始仓位的比例、部分平仓序号、结果、持仓时间和新余额。在 MT4 上显示旧订单号和新订单号。
- 平仓：原因（止盈、止损、强制平仓、手动、由 EA 平仓、挂单被删除或过期）、入场价和出场价、以点数、金额、百分比和初始风险倍数（例如 +2.2R）表示的结果、持仓时间和新余额。
- 挂单触发：请求价格、成交价格和滑点。
- 报告：每日、每周和每月，可在您选择的时间自动发送，也可在面板上一键发送。
为手机屏幕设计的消息
- 第一行就是通知预览：品种、方向和事件，订阅者不用打开聊天就知道发生了什么。
- 价格放在等宽块中，最高价在最上面：买单从上到下显示 TP、入场价和 SL，卖单相反。距离带符号，+ 表示朝盈利方向。
- 小进度条：新订单的风险回报、平仓时从 SL 到 TP 的路径以及入场和出场位置、部分平仓的已平比例、报告中的胜率。
- 消息串：修改、部分平仓、平仓和挂单触发都回复新订单的消息，每笔交易在聊天中集中在一起（开关 "Reply to the signal"）。
- 消息末尾的品种标签，例如 #EURUSD：点一下即可查看该品种的所有信号（开关 "Symbol hashtag"）。
- 消息支持 5 种语言：英语、意大利语、德语、西班牙语和法语。
图表截图
- 在新订单和平仓时，EA 打开该品种的图表，画出交易（止损和止盈区域、入场线，平仓时还有从入场到出场的连线），截图后与文字一起发送。
- 您可以选择周期（当前周期或 M1 到 MN1）、像素尺寸（0 = 整个图表）以及决定颜色的图表模板。
- 平仓时画出的水平可以是最初的 SL/TP、最宽的 SL/TP 或最后的 SL/TP（Levels drawn）。
- 如果图表在 Screenshot time limit 内没有准备好，文字会在没有图片的情况下发出：消息不会因为截图而丢失。
发布什么由您决定
- 新订单延迟：信号在您设定的秒数后发出，带上这段时间内设置的 SL 和 TP，这些最初的调整不会作为修改发送。
- Announce market trades only with a stop loss：没有止损的交易会等待止损；如果止损没有及时设置，该信号及其后续所有消息都不会发送。
- 按魔术号、品种和注释过滤订单，可包含或排除，多个值用 ";" 分隔。过滤器同样适用于报告。
- 挂单：发布、修改和删除时都通知，或者保持静默，只在成为交易时才发布（Announce as new trade）。
- 所有消息一个总开关，每种消息一个开关，另外每条消息的每一行都有开关。
报告
- 每日报告每天发送，每周报告在您选择的那一天发送，每月报告在每月最后一天发送，时间为您所在时区的报告时间（GMT Offset）。每份报告只发送一次；终端重启后，最多延迟一小时仍会发送。
- 覆盖的时间段、以金额、百分比和点数表示的总结果、盈利、亏损和保本交易数、带进度条的胜率、盈利因子、最好和最差的交易。
- 已平仓交易列表（可选择把部分平仓合并为一行），然后是仍在持仓的交易及其浮动结果，以及未成交的挂单。
- "Break-even band (%)" 决定多小的结果算作保本。"Send even without trades" 决定没有交易的时段是否也发送报告。
消息如何发送
- 每 250 毫秒检查一次账户，在 MT5 上每次交易事件发生时也会检查。
- 每笔交易的状态都会保存：终端关闭期间发生的事件（例如夜间某笔交易触及 TP）会在 EA 再次启动时发送，任何事件都不会重复发送。首次启动时，已经存在的持仓会被接管而不发送消息。
- 当 Telegram 要求等待时，消息会等待并重新发送，最多 30 次。如果 Telegram 拒绝格式，消息会以纯文本发送。超过一条 Telegram 消息长度的文字会在行尾拆分。
- 如果缺少 WebRequest 权限，会弹出提示说明解决方法，最近一次的结果始终显示在面板上。
图表上的面板
- 主窗口：Daily report now、Weekly report now、Monthly report now、Settings、您所在时区的时钟以及最近一次的结果（已发送、等待中、错误）。
- Settings：Main settings、New trade、Trade closed、Partial exit、Order changes、Pending filled、Reports 和 Try a message，共 83 项设置。设置会被保存，重启后自动恢复。
- Try a message：一键在图表品种上发送测试用的新订单、平仓、修改或挂单触发消息，在交易前先在频道里查看效果。
- 深色窗口，可移动、最小化和缩放（Panel size）。
高级模式：您自己的文字
- 启用 "Use custom message files (advanced mode)" 后，消息来自可编辑的文本文件：新订单、平仓、部分平仓、修改、挂单触发和报告各一个文件。
- 文件位于 Terminal\Common\Files\EagleSignalProvider\CustomMsg。"Template" 文件夹每次启动都会按当前格式重写；复制它，给副本改名，并把名称填入 "Folder of your message files"。不存在的文件夹会根据模板自动创建。
- 每个数值都有占位符，有些行只在条件满足时显示（有注释、已设置 SL、已设置 TP、挂单或市价单），每个表情符号和每个平仓原因的文字都可修改，支持 Telegram 格式（粗体、斜体、等宽）。所有占位符都在 Info.txt 中说明。
- 每条消息都会重新读取文件：修改从下一条消息开始生效，无需重启 EA。
四步开始
1. 在 Telegram 中通过 BotFather 创建一个机器人并复制它的 token。把机器人加入您的群组或频道；在频道中把它设为有发布权限的管理员。
2. 在 MetaTrader 中："Tools, Options, Expert Advisors"（工具、选项、EA交易），允许列出的 URL 使用 WebRequest，并添加 https://api.telegram.org。
3. 把 EA 加载到一个图表上，填写 Telegram bot token 和 Telegram chat ID（群组或频道的 ID 是负数，频道 ID 以 -100 开头）。
4. 打开 Settings、Try a message，发送一条测试消息：它会出现在您的聊天中。从此账户的每笔交易都会被发布。
使用要求
- 每个账户和聊天在一个图表上运行一个 EA。两个使用不同过滤器的 EA 可以发布到同一个聊天。
- 终端必须保持打开并连接：在 Windows VPS 上，即使您的电脑关机，消息也会照常发出。
- 支持对冲账户和净额账户。在净额账户上，向持仓加仓的数量不会发布。
- EA 不交易，也不修改您的订单：它只读取账户并发送消息。
- 策略测试器无法连接 Telegram：在测试器中，EA 会把每条消息写入日志，而不是发送出去。
- 提供 MetaTrader 5 和 MetaTrader 4 两个版本，作为功能相同的两个产品：请安装与您的终端对应的版本。
参数：TELEGRAM
- Telegram chat ID：接收消息的聊天、群组或频道。
- Telegram bot token：您的机器人的 token。
- Use custom message files (advanced mode)：使用自定义文件夹中的文本文件代替内置格式。
- Folder of your message files：Terminal\Common\Files\EagleSignalProvider\CustomMsg 中存放您文件的文件夹名称。
- Wait before announcing a new trade (seconds)：发布新订单前的等待时间。
- Announce market trades only with a stop loss：不发布没有止损的市价交易。
- Extra wait for the stop loss (seconds)：放弃信号之前额外等待止损的时间。
- Panel size：Automatic（根据屏幕设置）或 75% 到 200%。
- Chart loading time before the screenshot (seconds)：截图前等待图表加载的最短时间。
- Screenshot time limit (seconds)：超过该时间，文字将不带图片发出。
参数：订单过滤器
- Publish only these magic numbers / Never publish these magic numbers：例如 1001;1002。
- Publish only these symbols / Never publish these symbols：例如 EURUSD;XAUUSD。
- Publish only comments containing / Never publish comments containing：交易注释中的一段文字，例如 Scalper。
- 留空 = 不过滤。不区分大小写。
面板设置
- Main settings：Publish to Telegram、Publish pending orders、Your time zone (GMT)、Break-even band (%)、Distances in (Pips / Points)、% relative to (Balance / Equity)、Picture width (px)、Picture height (px)、Chart template for pictures、Message language、Reply to the signal、Symbol hashtag。
- New trade：Publish new trades、Attach chart picture、Picture timeframe、Ticket number、Lot size、Stop loss price、Stop loss distance、Take profit price、Take profit distance、Risk/reward bar、Account size、Risk in money and %、Target in money and %、Free margin、Margin level、Trade comment、Your extra text。
- Trade closed：Publish closed trades、Attach chart picture、Levels drawn (First / Widest / Last SL/TP)、Ticket number、Entry price、Exit price、Result in money、Result in %、Result in pips/points、Lot size、Time in the trade、Balance after closing、Reason in the title、Your extra text。
- Partial exit：Publish partial exits、Ticket number、Closed share、Number of the partial、Result in money、Result in %、Result in pips/points、Closed and left lots、Time in the trade、Balance after closing、Closed share text、Your extra text。
- Order changes：Publish order changes、Ticket number、Previous value、Risk/target distance、Risk/target in money、Risk/target in %。
- Pending filled：Publish pending fills、Announce as new trade、Ticket number。
- Reports：Daily report、Weekly report、Monthly report、Sending time、Weekly report day、Send even without trades、Buy / sell in the list、Pips/points in the list、% in the list、Join partial exits、Total in pips/points、Total in money、Total in %、Counts and statistics、Win rate、Open trades、Pending orders、Note under joined partials、Your extra text。
风险提示
本 EA 只报告您账户的交易；它不开仓，也不提供交易建议。消息和报告中的结果是该账户过去的结果，不能预测未来的结果。跟随信号的人可能因点差、滑点、消息送达时间和经纪商条件而得到不同的结果。在向订阅者发布之前，请先在模拟账户和私人测试频道中试用本 EA。
欢迎在本产品的评论区或通过 MQL5 私信提出问题和建议。
