DocFX MT5 to Telegram Signal Provider

Introduction

Broadcasts your MetaTrader 5 trades to a Telegram channel, group or chat: opens, pending orders, stop-loss and take-profit changes, breakeven, partial closes, and closes with the reason. Each trade posts as one thread of replies.

Full description

DocFX MT5 to Telegram Signal Provider sends your trades to Telegram as they happen. Attach it to any chart, give it a bot token and a channel, and from then on every action on the account is posted for you: entries, pending orders, stop changes, breakeven, partial closes and closes. You don't type anything.

It doesn't open, modify or close trades. It watches the account and reports.

What it reports

• Trade opened (market orders)
• Pending order placed: buy/sell limit and stop
• Pending order triggered: reported as TRIGGERED, along with the pending type it came from
• Pending order entry price moved, showing the new price and the old one
• Stop loss or take profit changed, on open trades and on resting pending orders
• Breakeven: recognised as its own event when the stop loss moves onto the entry price
• Partial close, with the closed volume, remaining volume and realised P/L
• Position size increased (scale-in, netting accounts)
• Full close, with exit price, pips, P/L, how long the trade was held, and why it closed: Stop Loss Hit, Take Profit Hit, Stop Out, Manual Close, or Closed by EA/Script
• Pending order cancelled

Every event type has its own on/off switch.

Each trade is one thread

Every later message about a trade is posted as a Telegram reply to the message that opened it. Your followers see a trade's whole history in one place, from entry through to the close. The thread links survive an EA restart. Threading can be switched off.

Five message styles

• Full Detail: one labelled line per field. Empty fields are left out instead of printed as zeros.
• Compact: the whole event on one line.
• Emoji: the look most public signal channels use, with a marker that matches the event (win, loss, breakeven, partial, and so on).
• Follower-Compatible: a strict, machine-readable layout made for trade-copier tools that read Telegram.
• Custom: your own template, with placeholders for event, symbol, side, entry, exit, SL, TP, lots, risk %, P/L, pips, duration, close reason, ticket and time. Type \n for a line break.

You can add your own header and footer text to every message, for example your channel name, a disclaimer or a link.

Chart screenshots (optional)

The EA can attach a picture of the chart to the signal. It looks for an open chart of the traded symbol, so a GBPUSD signal gets a GBPUSD chart, with your own template and analysis on it. The signal text goes in as the picture's caption, so each signal is one post. If no matching chart is open or the upload fails, the signal still goes out as text. Keep a chart of each symbol you trade open if you want pictures with your signals. You choose when pictures are sent: never, opens only, opens and closes, or every event.

Which trades

• The whole account by default, or only the chart's own symbol
• Every trade by default, or only one magic number
• Include or exclude manually placed trades
• Ignore trades below a minimum lot size, which keeps test trades out of the channel

Reliable by design

• Each event is sent once. A restart doesn't re-announce open trades, and nothing that happened while the EA was off is posted later as old news.
• When several things happen at once, such as a basket close or a news spike taking out several stops, the messages go out in the order the events happened.
• Telegram's rate limits are respected. If Telegram asks the EA to slow down, it waits exactly as long as asked instead of dropping the message.
• If a send fails after retries, the EA logs it and moves on. It won't flood your channel with a backlog hours later.

Easy setup, clear diagnostics

• When it loads, the EA checks your token and that the bot is allowed to post, without posting anything. The panel shows Ready when the check passes.
• Paste your channel almost any way: @name, name, a t.me link, or a numeric ID. The EA tidies it up and logs what it read.
• If Telegram refuses a message, the log shows Telegram's own reason ("chat not found", "bot is not a member of the channel") rather than a bare error code.
• Every decision is written to the Experts tab: sent, skipped, filtered, paused or failed, each with its reason.
• A small on-chart panel shows connection status, the destination, the number of signals sent, the time of the last one, and a Pause/Resume button.

Setup in four steps

1. In Telegram, open @BotFather, create a bot and copy the token it gives you.
2. Add the bot to your channel or group as an administrator. This is the step most people miss, and without it Telegram refuses every message. The bot needs one right: under Manage messages, switch on Post messages and leave every other right off. The EA only posts new messages and replies to its own signals; it never edits or deletes anything.
3. Enter the token and your channel (@yourchannel, or the -100... numeric ID for a private channel) in the EA inputs.
4. In MetaTrader, go to Tools > Options > Expert Advisors, tick "Allow WebRequest for listed URL" and add https://api.telegram.org

About the demo

MetaTrader doesn't allow internet connections in the Strategy Tester, so the demo version cannot send to Telegram. Run it in the visual tester and open the Experts (Journal) tab: you'll see every trade event the EA detects and would have broadcast, with the reason it was held back.

Notes

• Works with any broker and any symbol, on hedging and netting accounts.
• Works next to any other EA or manual trading. It only reads the account.
• One EA instance is one destination. To post to two channels, attach it to two charts.
• A partial close of a trade that started before the EA was attached is reported from the volume the EA can see.