Eagle Telegram Signal Provider
- Utilities
- Version: 1.4
Signal Provider
Publishes the trades of your account in a Telegram chat, group or channel while you trade: new orders, modifications, partial closures, closures, pending orders and daily, weekly and monthly reports. Each message shows the price levels, the risk in money and in percent, the result and, if you want, a screenshot of the chart with the trade drawn on it. Nothing to type: you trade, the EA writes.
Eagle Signal Provider follows every trade and pending order of the account and sends a clear Telegram message for each event, a few moments after it happens. Your subscribers see what you did, at which price, with how much risk and with which result, in a format that reads well on a phone. Delay, stop loss rules and filters decide what is published, so a manual trade, another EA or a trade without stop loss does not end up in the channel by mistake.
WHAT YOUR SUBSCRIBERS RECEIVE
- New order: symbol, direction, entry, SL and TP with their distance, lot size, risk and target in money and in % of balance or equity, risk/reward ratio, account line and comment.
- Modification: what the change means, in words: stop at break-even, profit locked, risk reduced or increased, stop loss set or removed, target extended, reduced, set or removed, order moved. Old and new price, then the risk and the target after the change.
- Partial closure: closed and remaining lots, share of the initial size, partial number, result, duration and new balance. On MT4 the old and the new ticket.
- Closure: the reason (take profit, stop loss, stop out, manual, closed by an Expert, pending order deleted or expired), entry and exit, result in pips, money, % and multiples of the initial risk (for example +2.2R), duration and new balance.
- Pending activation: the requested price, the fill price and the slippage.
- Reports: daily, weekly and monthly, automatic at the time you choose or sent with one click from the panel.
MESSAGES BUILT FOR A PHONE SCREEN
- The first line is the notification preview: instrument, direction and event, so the subscriber knows what happened before opening the chat.
- Prices in a fixed-width block, highest price on top: a buy shows TP, entry and SL from top to bottom, a sell the opposite. Distances carry a sign, + toward profit.
- Small bars: risk/reward on the new order, the path from SL to TP with entry and exit on the closure, the closed share on a partial closure, the winrate in the report.
- Threads: modifications, partial closures, closure and activation reply to the message of the new order, so each trade stays together in the chat (switch "Reply to the signal").
- A symbol hashtag at the end, for example #EURUSD: a tap shows every signal of that instrument (switch "Symbol hashtag").
- Messages in 5 languages: English, Italian, German, Spanish and French.
CHART SCREENSHOTS
- On new orders and closures the EA opens a chart of the symbol, draws the trade (stop loss and take profit zones, the entry line and, on the closure, the line from entry to exit), takes the picture and sends it with the text.
- You choose the period (current or M1 to MN1), the size in pixels (0 = whole chart) and a chart template for the colors.
- On the closure the drawn levels can be the first SL/TP, the widest ones or the last ones (Levels drawn).
- If the chart is not ready within the Screenshot time limit, the text is sent without the picture: a message is never lost because of a screenshot.
WHAT IS PUBLISHED IS UNDER YOUR CONTROL
- Delay for new orders: the signal leaves after the seconds you set, with the SL and TP you placed in the meantime, and those first adjustments are not sent as modifications.
- Announce market trades only with a stop loss: a trade without stop loss waits for one; if no stop loss arrives in time, the signal and all its later messages are not sent.
- Order filter on magic number, symbol and comment, to include or exclude, several values separated by ";". The filter applies to the reports too.
- Pending orders: announced, modified and deleted, or kept silent and announced only when they become a trade (Announce as new trade).
- One switch for all messages and one for each type, plus a switch for every line of every message.
REPORTS
- Daily every day, weekly on the day you choose, monthly on the last day of the month, at the report time in your time zone (GMT Offset). Each report is sent once; after a restart of the terminal it is still sent up to one hour late.
- Covered period, total result in money, % and pips, wins, losses and break-even trades, winrate with bar, profit factor, best and worst trade.
- The list of closed trades, with partial closures merged into one line if you want, then the trades still running with their floating result and the open pending orders.
- "Break-even band (%)" decides when a small result counts as break-even. "Send even without trades" decides whether an empty period is reported.
HOW MESSAGES ARE DELIVERED
- The account is checked every 250 milliseconds and, on MT5, at every trade event.
- The state of every trade is saved: what happens while the terminal is closed (a trade hits its TP during the night, for example) is sent when the EA starts again, and no event is sent twice. On the first start the trades already open are taken over without messages.
- When Telegram asks to wait, the message waits and is sent again, up to 30 attempts. Formatting refused by Telegram: the message is sent as plain text. A text longer than one Telegram message is split at the end of a line.
- A missing WebRequest permission is explained in an alert with the steps to fix it, and the last result is always written on the panel.
THE PANEL ON THE CHART
- Main window: Daily report now, Weekly report now, Monthly report now, Settings, the clock in your time zone and the last result (sent, waiting, error).
- Settings: Main settings, New trade, Trade closed, Partial exit, Order changes, Pending filled, Reports and Try a message, with 83 settings in all. Settings are saved and come back after a restart.
- Try a message: one click sends a sample new order, closure, modification or pending activation on the chart symbol, to see the result in your channel before trading.
- Dark windows that you can move, minimize and scale (Panel size).
ADVANCED MODE: YOUR OWN TEXT
- With "Use custom message files (advanced mode)" the messages come from text files that you can edit: one for new orders, closures, partial closures, modifications, pending activations and reports.
- The files are in Terminal\Common\Files\EagleSignalProvider\CustomMsg. The folder "Template" is written again at every start with the current format; copy it, rename the copy and write its name in "Folder of your message files". A folder that does not exist is created from the template.
- Placeholders for every value, lines shown only when a condition is true (comment present, SL set, TP set, pending or market order), the text of each emoji and close reason, Telegram formatting (bold, italic, fixed width). Every placeholder is explained in Info.txt.
- The files are read again for every message: a change is used at the next message, without restarting the EA.
START IN FOUR STEPS
1. In Telegram, create a bot with BotFather and copy its token. Add the bot to your group or channel; in a channel, make it an administrator with permission to post.
2. In MetaTrader: Tools, Options, Expert Advisors, enable "Allow WebRequest for listed URL" and add https://api.telegram.org.
3. Attach the EA to one chart and fill in Telegram bot token and Telegram chat ID (the ID of a group or channel is negative, a channel ID starts with -100).
4. Open Settings, Try a message and send a test message: it appears in your chat. From now on every trade of the account is published.
REQUIREMENTS
- One EA on one chart per account and chat. Two EAs with different filters can publish to the same chat.
- The terminal must stay open and connected: on a Windows VPS the messages leave also when your computer is off.
- Hedging and netting accounts. On netting accounts, volume added to a position is not announced.
- The EA does not trade and does not change your orders: it only reads the account and sends messages.
- In the Strategy Tester Telegram cannot be reached: there the EA writes each message in the journal instead of sending it.
- Available for MetaTrader 5 and for MetaTrader 4, as two products with the same functions: install the one that matches your terminal.
PARAMETERS: TELEGRAM
- Telegram chat ID: the chat, group or channel that receives the messages.
- Telegram bot token: the token of your bot.
- Use custom message files (advanced mode): messages from the text files of the custom folder instead of the built-in format.
- Folder of your message files: name of the folder with your files inside Terminal\Common\Files\EagleSignalProvider\CustomMsg.
- Wait before announcing a new trade (seconds): wait before announcing a new order.
- Announce market trades only with a stop loss: do not announce a market trade without stop loss.
- Extra wait for the stop loss (seconds): extra wait for the stop loss before the signal is discarded.
- Panel size: Automatic (from the screen settings) or 75% to 200%.
- Chart loading time before the screenshot (seconds): minimum wait for the chart to load before the picture.
- Screenshot time limit (seconds): after this time the text leaves without the picture.
PARAMETERS: ORDER FILTER
- Publish only these magic numbers / Never publish these magic numbers: for example 1001;1002.
- Publish only these symbols / Never publish these symbols: for example EURUSD;XAUUSD.
- Publish only comments containing / Never publish comments containing: part of the trade comment, for example Scalper.
- Empty = no filter. Upper and lower case are the same.
PANEL SETTINGS
- 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.
RISK NOTICE
The EA reports the trades of your account; it does not open trades and does not give trading advice. The results in the messages and reports are past results of this account and do not predict future results. Whoever follows the signals can get different results because of spread, slippage, the time the message takes to arrive and broker conditions. Try the EA on a demo account and a private test channel before publishing to your subscribers.
Questions and suggestions are welcome in the comments of this product or by private message on MQL5.
