Private Trade Alerts to Telegram
- Utilitys
-
Themistokli Kola
MQL4 / MQL5 and Pine Script developer.
What I do:
- Pine Script to MQL5 / MQL4 conversions (TradingView indicators and strategies into MT5/MT4 indicators or EAs)
- Fixes and changes to existing EAs and indicators: bugs, new inputs, filters, daily limits, breakeven and trailing logic - Version: 1.0
- Aktivierungen: 5
„Private Trade Alerts to Telegram“ sendet die Ereignisse Ihres eigenen MetaTrader-5-Kontos über Ihren eigenen Telegram-Bot an Ihren eigenen Telegram-Chat: eröffnete und geschlossene Positionen, Teilschließungen, Änderungen von SL und TP, ausstehende Orders, eine tägliche Zusammenfassung und optionale Warnungen. Der Dienst meldet lediglich, was auf dem Konto passiert ist. Er eröffnet, ändert oder schließt niemals einen Trade und gibt keine Signale oder Ratschläge.
Einrichtung in 5 Schritten
- Erstellen Sie Ihren Bot. Öffnen Sie in Telegram den offiziellen „BotFather“-Chat, senden Sie den Befehl „newbot“ und folgen Sie den Anweisungen. Sie erhalten ein Bot-Token (zwei durch einen Doppelpunkt verbundene Teile). Bewahren Sie es vertraulich auf: Jeder, der es besitzt, kann als Ihr Bot Nachrichten versenden.
- Finden Sie Ihre Chat-ID heraus. Senden Sie eine beliebige Nachricht an Ihren neuen Bot und ermitteln Sie dann Ihre numerische Chat-ID, beispielsweise mit einem Chat-ID-Hilfsbot in Telegram. Bei einer privaten Gruppe fügen Sie den Bot der Gruppe hinzu; Gruppen-IDs beginnen mit einem Minuszeichen.
- Erlaube die Telegram-Adresse in MetaTrader 5. Setze unter „Extras“, „Optionen“, „Expert Advisors“ ein Häkchen bei „WebRequest für aufgeführte URL zulassen“ und füge die Telegram-Bot-API-Adresse hinzu. Die genaue Adresse wird im Bedienfeld und im Expertenprotokoll angezeigt, falls sie fehlt; du kannst sie also von dort kopieren.
- Fügen Sie den EA hinzu. Ziehen Sie „Private Trade Alerts to Telegram“ auf ein beliebiges Chart des Kontos. Geben Sie das Bot-Token und die Chat-ID ein, wählen Sie die gewünschten Ereignisse aus und klicken Sie auf „OK“. Ein Chart pro Konto reicht aus: Der EA meldet jedes Symbol des Kontos, sofern Sie diese nicht filtern.
- Überprüfen Sie die Testnachricht. Wenn „Testnachricht beim Start senden“ aktiviert ist, erscheint innerhalb weniger Sekunden die Meldung „Alerts gestartet“ in Ihrem Chat und das Panel zeigt den Status „Bereit“ an. Lassen Sie das Chart geöffnet: Die Benachrichtigungen werden gesendet, solange das Terminal läuft.
Telegram-Einstellungen
- Bot-Token – das Token aus Schritt 1. Im Bedienfeld oder im Protokoll werden immer nur die letzten 4 Zeichen angezeigt.
- Chat-ID – Ihre Chat-ID aus Schritt 2.
- Zweite Chat-ID (optional) – ein zweites Ziel, zum Beispiel eine private Gruppe. Jede Nachricht wird an beide gesendet.
- Testnachricht beim Start senden – sendet bei jedem Start des EAsdie Meldung „Benachrichtigungen gestartet“, damit du sehen kannst, dass die Verbindung funktioniert.
- HTML-Formatierung verwenden – zeigt die Nachrichtentitel fett an. Aus = einfacher Text.
Ereignisse
- Eröffnete Positionen – Symbol, Kauf oder Verkauf, Volumen, Kurs, SL, TP, Magic Number oder „manuell“, Kommentar, Uhrzeit.
- Schließungen und Teilschließungen – geschlossenes Volumen, Schlusskurs, Eröffnungskurs, Ergebnis in der Kontowährung und optional in Punkten sowie der Grund: manuell, durch einen Expert Advisor, SL erreicht, TP erreicht, Stop-out. Bei einer Teilschließung wird auch das verbleibende Volumen angezeigt.
- SL- und TP-Änderungen – alter und neuer SL und TP der Position.
- Pending-Orders – platziert, geändert (alter und neuer Kurs, SL, TP), gelöscht, abgelaufen. Eine ausgeführte Pending-Order wird als „Pending-Order ausgeführt – Position eröffnet“ gemeldet.
- Tägliche Zusammenfassung – einmal täglich: geschlossene Trades des Tages, Summe ihrer Ergebnisse, Kontostand, Eigenkapital und offene Positionen.
- Zeitpunkt der täglichen Zusammenfassung – HH:MM in Terminalzeit (Handelsserverzeit), zum Beispiel 23:55. Wird der EA nach diesem Zeitpunkt gestartet, wird die Zusammenfassung dieses Tages übersprungen, anstatt verspätet gesendet zu werden.
- Margin-Level-Warnung unterhalb dieses Prozentsatzes – eine Warnung, wenn der Margin-Level unter diesen Wert fällt, jedoch nur, solange Positionen offen sind. Sie wird erst wieder gesendet, nachdem sich der Level erholt hat. 0 = aus.
- Warnung bei täglichem Eigenkapitalrückgang in % – eine Warnung, einmal täglich, wenn das Eigenkapital um diesen Prozentsatz unter dem Eigenkapital zu Tagesbeginn liegt. 0 = aus.
- Benachrichtigung bei Wiederherstellung der Terminalverbindung – eine Meldung, nachdem die Verbindung zum Handelsserver für mehr als einige Sekunden unterbrochen war und wiederhergestellt wurde.
- Heartbeat-Meldung alle N Stunden – eine kurze Meldung „Warnungen laufen“ mit Kontostand und Eigenkapital. 0 = aus.
Filter und Format
- Symbole – durch Kommas getrennte Liste, zum Beispiel EURUSD,XAUUSD. Leer = alle Symbole.
- Magic Number – nur Trades mit dieser Magic Number des Expert Advisors melden; -1 = alle.
- Manuelle Trades einbeziehen – manuell eröffnete Trades melden (Magic Number 0).
- Kontoname – wird oben in jeder Meldung in eckigen Klammern angezeigt. Leer = „Konto ****“ und die letzten 4 Ziffern der Kontonummer.
- Ergebnisse auch in Punkten anzeigen – fügt das Ergebnis in Punkten zu den Abschlussmeldungen hinzu.
- Zeitzonenverschiebung für Meldungszeiten – Stunden, die zu den in den Meldungen angezeigten Zeiten addiert werden.
- Panel anzeigen, Panel X, Panel Y – das kleine Panel auf dem Chart und dessen Position. Die Minus-Schaltfläche reduziert es auf eine Zeile, die Plus-Schaltfläche öffnet es wieder.
Das Panel
Produktname; Status (Bereit, Wird gesendet, Füge die Telegram-Adresse in den Optionen hinzu, Token oder Chat-ID fehlt, Bot-Token von Telegram abgelehnt, Tester: wird versendet); Chat und Token (nur die letzten 4 Zeichen); heute gesendete Nachrichten und die Länge der Warteschlange; die Uhrzeit der letzten Nachricht; sowie der letzte Fehler in einfachen Worten.
Versenden, Limits und Fehler
- Nachrichten warten in einer Warteschlange und werden mit einer Rate von einer pro Sekunde versendet, maximal 20 pro Minute (Telegram-eigene Limits). Die Warteschlange fasst bis zu 200 Nachrichten; darüber hinaus wird die älteste Nachricht verworfen, was im Expertenprotokoll vermerkt wird.
- Wenn Telegram eine Verlangsamung verlangt oder das Netzwerk ausfällt, wird der Versand der Nachricht nach einer kurzen Wartezeit erneut versucht.
- Fehlt die Berechtigung „WebRequest“, geben das Bedienfeld und das Expertenprotokoll die hinzuzufügende Adresse an; Nachrichten warten in der Warteschlange und werden gesendet, sobald die Adresse zugelassen ist.
- Wenn Telegram das Bot-Token ablehnt, wird der Versand gestoppt und dies im Panel angezeigt; korrigieren Sie das Token in den Eingabefeldern.
- Ereignisse, die auftreten, während das Terminal geschlossen ist, werden nicht nachträglich gesendet. Nach einem Neustart sendet der EA alte Ereignisse nicht erneut.
- Im Strategietester wird nichts gesendet, da „WebRequest“ dort nicht funktioniert; das Expertenprotokoll weist einmalig darauf hin.
