Telegram Trading Reporter MT5
- Utilità
- Juergen Marcus Wolfgang Rosswinkel
- Versione: 1.8
- Attivazioni: 5
Telegram Trading Reporter MT5 — Product Description (English)
Overview
The Simple Trading Reporter is a pure analysis and reporting Expert Advisor for MetaTrader 5. It does not open, close or modify any positions. Instead, it analyses the account trading history, generates structured performance reports and sends them automatically via Telegram to one or multiple channels. On request, visual charts captured directly from the MetaTrader terminal are attached as image files.
Core Features
Automatic Daily Reports at Configurable Times
The EA sends up to three daily reports at freely selectable hours. Each report contains a summary of trading performance over the configurable reporting period (1 to 30 days), broken down by profits, losses, win rate, profit factor and total volume traded.
Day-by-Day Performance Breakdown
For each day in the reporting period, profit/loss, number of trades, win rate and volume are listed individually. Days without any trades can optionally be hidden from the report.
Symbol Analysis
The EA automatically identifies which instruments were traded during the reporting period and ranks them by total performance. For each symbol the report shows profit, loss, number of trades, best single trade and worst single trade.
EA Performance Tracking by Magic Number
Multiple Expert Advisors can be monitored simultaneously. Comma-separated Magic Numbers uniquely identify each trading robot, which can additionally be given custom names. The report lists each EA with total performance, win rate, number of trades and volume, sorted by overall result.
Visual Charts Directly from MetaTrader
The EA generates up to four charts as overlay objects in the MetaTrader chart window and saves them as a single PNG file:
The daily bar chart shows profit/loss per day colour-coded in green and red. The symbol performance chart ranks top symbols by result as a bar chart. The EA performance chart visually compares all registered EAs. The account balance history chart shows the progression of balance and equity over the configured period as a line chart.
All charts are captured together in a single screenshot and sent via Telegram. The send mode can be set to photo, document or automatic with fallback.
Persistent Account Balance History
The EA records the account balance every 30 minutes to a CSV file on disk and automatically reloads it on the next start. This enables a continuous balance history spanning several weeks, surviving EA restarts. An automatic backup file protects against data loss during write errors. A recovery function allows the history to be reconstructed from the MetaTrader deal history if the file is lost.
Filter by Magic Number and Symbol
All analysis can be restricted to a specific Magic Number or a specific trading instrument. By default all trades are included regardless of Magic Number or symbol.
Include Open Positions
Currently open positions can optionally be included in today's daily statistics, so the day's performance also reflects the current floating profit/loss.
Multi-Channel Telegram Delivery
Reports can be sent simultaneously to multiple Telegram chat IDs entered as a comma-separated list. If HTML-formatted messages fail, the EA automatically falls back to plain text mode.
Immediate Report on Demand
The input parameter SendReportNow triggers an immediate report at any time without waiting for the next scheduled hour.
Input Parameters
General Settings
| Parameter | Description |
|---|---|
| MagicNumber | Magic Number filter (0 = all trades) |
| SymbolFilter | Symbol filter (empty = all symbols) |
| IncludeOpenTrades | Include open positions in statistics |
| MaxDaysToReport | Number of days in the report period (max. 30) |
Report Settings
| Parameter | Description |
|---|---|
| OnlyReportWithTrades | Show only days that have trades |
| ReportHour | First report time (hour 0-23) |
| ReportHour2 | Second report time (-1 = disabled) |
| ReportHour3 | Third report time (-1 = disabled) |
| IncludeSymbolAnalysis | Include symbol performance in report |
| TopSymbolsToShow | Number of top symbols to display |
| SendReportNow | Trigger an immediate report (auto-resets) |
| DebugMode | Enable detailed diagnostic output in journal |
EA Performance Settings
| Parameter | Description |
|---|---|
| TrackEAPerformance | Enable EA performance tracking |
| EAMagicNumbers | Magic Numbers of EAs, comma-separated |
| EANames | EA names, comma-separated (matching magic numbers) |
| TopEAsToShow | Number of top EAs to display |
| ShowEAPerformanceChart | Create visual EA comparison chart |
Telegram Settings
| Parameter | Description |
|---|---|
| UseTelegram | Enable Telegram notifications |
| TelegramBotToken | Bot token from BotFather |
| TelegramChatIDs | Chat IDs, comma-separated |
| SendTestMessageOnStartup | Send a test message when EA starts |
| SendChartAs | Send mode: "auto", "photo" or "document" |
Visualization Settings
| Parameter | Description |
|---|---|
| CreateTradeChart | Create daily bar chart |
| ShowAccountBalanceChart | Create account balance history chart |
| SendChartWithReport | Attach chart image to report |
| ChartWidth | Chart width in pixels |
| ChartHeight | Chart height in pixels |
| BalanceHistoryDays | Number of days for balance history display |
Requirements
For Telegram delivery, MetaTrader 5 must be configured to allow WebRequests. Go to Tools > Options > Expert Advisors, enable "Allow WebRequest for listed URL" and add https://api.telegram.org. Without this setting no messages can be sent.
The EA requires a valid Telegram bot token created via BotFather and the numeric chat ID of the target channel or group.
Technical Notes
The EA does not execute any trading operations. Trade history analysis is performed in read-only mode via the MetaTrader API. The account balance history is stored as a CSV file in the terminal data path and automatically backed up. If the file is lost, the history can be reconstructed from the MetaTrader deal history. The EA is designed for continuous 24/5 operation on a VPS.
Version
1.08
