ExMachina Telegram Bridge - Experte für den MetaTrader 5

WAS ES MACHT

Der EA erkennt Handelsereignisse durch zwei unabhängige Mechanismen: den OnTradeTransaction-Handler für die Erkennung in Echtzeit und eine periodische Überprüfung des Handelsverlaufs als Fallback. Ein Deduplizierungssystem stellt sicher, dass Sie niemals dieselbe Benachrichtigung zweimal erhalten, selbst wenn beide Mechanismen bei demselben Ereignis ausgelöst werden.

Unterstützte Benachrichtigungen:

- Handelseröffnung: Symbol, Richtung (BUY/SELL), Volumen, Preis, SL, TP, magische Zahl, Handelsticket

- Trade geschlossen: Symbol, Volumen, Schlusskurs, Brutto-P/L, Kommission, Swap, Netto-P/L, aktualisierter Saldo

- SL/TP geändert: alte und neue Werte werden nebeneinander angezeigt (z. B. SL: 1924,00 → 1926,50)

- Pending Orders platziert: Typ (Buy Limit, Sell Limit, Buy Stop, Sell Stop, Buy Stop Limit, Sell Stop Limit), Preis, Volumen

- Positionsumkehr: neue Richtung, geschlossener P/L

- Einzahlungen und Abhebungen: Betrag und aktualisierter Saldo

- Periodische Kontozusammenfassungen: Saldo, Eigenkapital, freie Marge, gleitender P/L, Session P/L, offene Positionen, Tageshöchst-/Tiefstwert, Drawdown-Prozentsatz

- Verbindungs- und Trennungsnachrichten mit Sitzungsstatistiken

EINRICHTUNG - SCHRITT FÜR SCHRITT

Sie benötigen zwei Dinge von Telegram: einen Bot Token und Ihre Chat ID.

Schritt 1: Erstellen Sie einen Telegram-Bot

Öffnen Sie Telegram, suchen Sie nach @BotFather und beginnen Sie eine Konversation. Senden Sie den Befehl /newbot. BotFather wird Sie bitten, einen Anzeigenamen (den Sie frei wählen können) und einen Benutzernamen (der auf "bot" enden muss) zu wählen. Nach der Erstellung sendet dir BotFather ein API-Token - eine lange Zeichenkette, die wie 7123456789:AAH1bCdEfGhIjKlMnOpQrStUvWxYz aussieht. Kopieren Sie dieses Token.

Schritt 2: Erhalten Sie Ihre Chat-ID

Suchen Sie in Telegram nach @userinfobot (oder @getmyid_bot) und senden Sie ihm eine beliebige Nachricht. Er antwortet mit Ihrer numerischen Chat-ID (z. B. 123456789). Kopieren Sie diese Nummer.

Für Gruppenbenachrichtigungen: Fügen Sie Ihren Bot zu einer Telegram-Gruppe hinzu und verwenden Sie dann @getidsbot in der Gruppe, um die Chat-ID der Gruppe zu erhalten (negative Zahl, z. B. -1001234567890).

Schritt 3: Beginnen Sie eine Konversation mit Ihrem Bot

Dieser Schritt ist leicht zu vergessen. Finden Sie Ihren Bot über seinen Benutzernamen in der Telegram-Suche, öffnen Sie ihn und drücken Sie auf Start. Wenn Sie diesen Schritt überspringen, wird die API von Telegram alle Nachrichten ablehnen.

Schritt 4: Erlauben Sie WebRequest in MetaTrader 5

Gehen Sie in MT5 zu Extras → Optionen → Expert Advisors. Markieren Sie "WebRequest für aufgelistete URL zulassen". Klicken Sie auf Hinzufügen und geben Sie genau ein: https://api.telegram.org - dann klicken Sie auf OK. Dies ist eine einmalige Konfiguration. Wenn Sie diesen Schritt überspringen, wird der WebRequest-Fehler 4014 auf der Registerkarte "Experten" angezeigt und es werden keine Nachrichten gesendet.

Schritt 5: Installieren Sie den EA

Kopieren Sie ExMachina_TelegramBridge.mq5 in den Ordner MQL5/Experts/ (Zugriff über Datei → Datenordner öffnen in MT5). Öffnen Sie MetaEditor (F4), navigieren Sie zu der Datei und drücken Sie Compile (F7). Sie sollten 0 Fehler und 0 Warnungen sehen.

Schritt 6: Anhängen an einen Chart

Ziehen Sie den EA aus dem Navigator-Panel auf einen beliebigen Chart. Fügen Sie im Einstellungsdialog Ihr Bot-Token und Ihre Chat-ID ein. Klicken Sie auf OK. Innerhalb weniger Sekunden sollten Sie eine Verbindungsnachricht in Telegram erhalten, die Ihre Kontonummer, den Server, den Kontostand, das Eigenkapital und die Anzahl der offenen Positionen anzeigt.

EINGABEPARAMETER

Telegram-Konfiguration:

- Bot Token: Ihr API Token von @BotFather (erforderlich)

- Chat-ID: Ihre numerische Chat-ID (erforderlich, kann eine Gruppen-ID sein)

Benachrichtigungs-Einstellungen:

- Notify on Trade Open: wahr/falsch (Standard: wahr)

- Benachrichtigung bei Handelsschluss: wahr/falsch (Standard: wahr)

- Benachrichtigung bei SL/TP-Änderung: true/false (Standard: true)

- Benachrichtigung bei Pending Orders: true/false (Standard: true)

- Bei Einzahlung/Abhebung benachrichtigen: wahr/falsch (Standard: wahr)

Konto-Zusammenfassung:

- Zusammenfassungsbericht Intervall: Aus, Alle 1 Stunde, Alle 4 Stunden, Alle 8 Stunden, Alle 24 Stunden (Standard: Alle 4 Stunden)

- Eigenkapital in die Zusammenfassung einbeziehen: wahr/falsch (Standardwert: wahr)

- Drawdown-Informationen einbeziehen: wahr/falsch (Standard: wahr)

Anzeige & Stil:

- Nachrichtenstil: Minimal (kompakt, einzeilig), Detailliert (vollständige Informationen mit Beschriftungen) oder Emoji-reich (detailliert mit Unicode-Symbolen). Voreinstellung: Emoji-reich.

- Dashboard im Diagramm anzeigen: wahr/falsch (Standard: wahr)

- Dashboard Hintergrund, Textfarbe, Akzentfarbe: anpassbar. Standardmäßig wird die ExMachina-Stahlpalette verwendet.

Filter:

- Symbol-Filter: Komma-getrennte Liste der zu überwachenden Symbole. Leer lassen für alle Symbole. Beispiel: "EURUSD,XAUUSD"

- Min Lot Size to Notify: Mindestvolumen, um eine Benachrichtigung auszulösen. 0 = kein Filter. Nützlich, um Mikro-Lots zu ignorieren.

- Magic Number Filter: Benachrichtigung nur bei Geschäften mit dieser spezifischen Magic Number. -1 = alle Geschäfte (einschließlich manueller Geschäfte).

NACHRICHTENSYSTEME

Minimal - kompaktes einzeiliges Format:

XAUUSD | BUY | 0,50 Lots @ 1928,45

Detailliert - strukturiert mit beschrifteten Feldern:

HANDEL GESCHLOSSEN

━━━━━━━━━━━━━━━━━━━━

Symbol: XAUUSD

Schließen: SELL (schließen BUY)

Volumen: 0,50 Lots

Preis: 1935,20

───────────────────

Brutto-Gewinn/Verlust: +$340.00

Kommission: -$2.50

Tausch: -$0.00

Netto Gewinn/Verlust: +$337.50

Saldo: $10,585.00 USD

Handel #182947363

Emoji-reich (Standard) - wie Detailliert, aber mit Unicode-Symbolen für jedes Feld. Handelseröffnungen zeigen einen grünen Kreis für KAUFEN und einen roten Kreis für VERKAUFEN. Schließungen zeigen ein Häkchen für Gewinn und ein Kreuz für Verlust.

FILTER

Der Filter Magische Zahl ist besonders nützlich, wenn Sie mehrere EAs auf demselben Konto betreiben. Setzen Sie ihn auf die magische Zahl eines bestimmten EAs, um nur Benachrichtigungen von diesem EA zu erhalten. Setzen Sie ihn auf -1, um alles zu erhalten (einschließlich manueller Trades).

Der Symbol-Filter akzeptiert eine kommagetrennte Liste: "XAUUSD,EURUSD,GBPUSD". Nur bei Geschäften mit diesen Symbolen werden Benachrichtigungen generiert. Lassen Sie ihn leer, um alle Symbole zu überwachen.

KONTOZUSAMMENFASSUNGEN

Regelmäßige Zusammenfassungen umfassen: Kontostand, Eigenkapital, freie Marge, Anzahl der offenen Positionen, gleitender Gesamtumsatz (einschließlich Swap), Sitzungsumsatz seit dem Start des EA, Tageshöchstwert, Tagestiefstwert und prozentualer Drawdown, berechnet vom Tageshöchstwert.

Nützlich für Prop-Firm-Händler, die die täglichen Drawdown-Limits aus der Ferne überwachen müssen. Stellen Sie das Intervall während aktiver Sitzungen auf 1 Stunde ein.

ON-CHART-DASHBOARD

Ein kompaktes Statuspanel in der oberen linken Ecke des Charts zeigt an:

- Verbindungsstatus: CONNECTED (grün) oder DISCONNECTED (rot)

- Bot-Benutzername

- Laufende Zähler: gesendete und fehlgeschlagene Nachrichten

- ExMachina-Slogan

Das Dashboard verwendet standardmäßig die ExMachina-Stahlpalette (Hintergrund C'8,10,18', Akzent C'0,180,220') und kann über die Display-Eingänge angepasst oder deaktiviert werden.

TESTMÖGLICHKEITEN

Schritt 1: Verbinden Sie den EA mit einem beliebigen Chart auf einem Demokonto. Überprüfen Sie die Registerkarte Experten auf "Verbunden mit Bot @IhrBotName". Überprüfen Sie Telegram auf die Verbindungsnachricht.

Schritt 2: Eröffnen Sie manuell eine kleine Marktorder (z.B. 0,01 Lots EURUSD). Sie sollten eine Benachrichtigung "TRADE OPENED" erhalten.

Schritt 3: Ändern Sie den SL oder TP Ihrer offenen Position (Rechtsklick → Ändern). Sie sollten eine Benachrichtigung "SL/TP MODIFIED" mit den alten → neuen Werten erhalten.

Schritt 4: Schließen Sie die Position. Sie sollten eine Benachrichtigung "TRADE CLOSED" mit einer P/L-Aufschlüsselung erhalten.

Schritt 5: Platzieren Sie eine schwebende Order (z.B. Buy Limit). Sie sollten eine Benachrichtigung "PENDING ORDER PLACED" erhalten.

Schritt 6: Entfernen Sie den EA aus dem Chart. Sie sollten eine "Disconnected"-Meldung mit Sitzungsstatistiken erhalten.

Schneller Browsertest: Um Ihr Token und Ihre Chat-ID zu überprüfen, bevor Sie den EA verwenden, fügen Sie diese URL in einen beliebigen Browser ein (ersetzen Sie die Platzhalter):

https://api.telegram.org/bot<YOUR_TOKEN>/sendMessage?chat_id=<YOUR_CHAT_ID>&text=Test

Wenn Sie in der Antwort {"ok":true} sehen, sind Ihre Anmeldedaten korrekt.

Schnelles Smoke-Test-Skript: Speichern Sie es als Skript (nicht EA) in MQL5/Scripts/, kompilieren Sie es und führen Sie es in einem Demo-Chart aus:

#include <Handel.mqh>

void OnStart()

{

CTrade.Trade;

trade.Buy(0.01, "EURUSD");

Sleep(3000);

for(int i = PositionsTotal()-1; i >= 0; i--)

{

if(PositionGetSymbol(i) == "EURUSD")

trade.PositionClose(PositionGetTicket(i));

}

}

Sie sollten sowohl eine Eröffnungs- als auch eine Schließungsbenachrichtigung in Telegram erhalten.

Wichtig: Dieser EA funktioniert nicht mit dem Strategy Tester. Der Strategy Tester unterstützt keine WebRequest (Netzwerkaufrufe). Der EA muss auf einem Live- oder Demo-Chart mit Internetzugang laufen.

LAUFEN ALONGSIDE ANDERER EAs

MT5 erlaubt nur einen EA pro Chart. Hängen Sie die Telegram Bridge an einen separaten Chart an (beliebiges Symbol). Sie überwacht das gesamte Konto, nicht nur den Chart, an den sie angehängt ist. Alle Trades von allen EAs und manuellen Trades werden erkannt, unabhängig davon, auf welchem Chart die Bridge läuft.

Verwenden Sie den Magic Number-Filter, um Benachrichtigungen auf einen bestimmten EA zu beschränken.

FEHLERSUCHE

Es werden keine Nachrichten empfangen:

1. Prüfen Sie, ob https://api.telegram.org in Tools → Options → Expert Advisors → Allow WebRequest aktiviert ist.

2. Überprüfen Sie, ob Bot Token und Chat ID korrekt sind (keine zusätzlichen Leerzeichen)

3. Stellen Sie sicher, dass Sie im Telegram-Chat Ihres Bots auf Start gedrückt haben.

4. Überprüfen Sie die Registerkarte Experten (Ansicht → Toolbox → Experten) auf Fehlermeldungen

WebRequest-Fehler 4014: Die Telegram-URL ist nicht in der zulässigen Liste enthalten. Dies ist das häufigste Problem.

HTTP 401 Unautorisiert: Ungültiges Bot-Token. Kopieren Sie es erneut von @BotFather.

HTTP 400 Bad Request: falsche Chat-ID, oder Sie haben keine Konversation mit Ihrem Bot begonnen.

HTTP 429 Zu viele Requests: Telegram-Rate-Limit. Der EA hat eine eingebaute Wiederholungslogik mit Backoff. Dies geschieht nur bei extrem hoher Handelsfrequenz.

EA zeigt INIT_PARAMETERS_INCORRECT: Bot Token und Chat ID sind beide erforderlich. Stellen Sie sicher, dass keines der beiden Felder leer ist.

Dashboard wird nicht angezeigt: Stellen Sie sicher, dass "Show Dashboard on Chart" in den EA-Eingaben auf true gesetzt ist.

TECHNISCHE DETAILS

- Handelserkennung: Dualer Mechanismus über OnTradeTransaction (Echtzeit) + Abfrage der Geschäftshistorie alle 2 Sekunden (Fallback)

- Deduplizierung: verarbeitete Geschäfte werden im Speicher gespeichert (die letzten 500 Geschäfte werden verfolgt)

- SL/TP-Erkennung: Positions-Snapshot-Array wird bei jedem Tick verglichen, Auslöser bei jeder Änderung

- Telegram API: HTTPS POST über WebRequest, URL-codierte Nutzdaten, Markdown-Parsing-Modus

- Wiederholungslogik: bis zu 3 Versuche pro Nachricht, 1-Sekunden-Verzögerung zwischen den Wiederholungen, 3-Sekunden-Verzögerung bei HTTP 429

- Verbindungstest: /getMe-Endpunkt, der bei Init aufgerufen wird, um das Token zu validieren und den Bot-Namen zu ermitteln

- Zusammenfassender Timer: EventSetTimer(60) prüft, ob das konfigurierte Intervall verstrichen ist

- Diagrammobjekte: alle Dashboard-Objekte verwenden das Präfix "EXTB_" und werden beim Deinitieren gelöscht

- Keine externen DLLs, keine Server von Drittanbietern. Direkte MT5 → Telegram Kommunikation über HTTPS.

Dieser EA ist kostenlos und quelloffen. Feedback, Bewertungen und Vorschläge sind willkommen.

ExMachina Trading Systems - Präzision vor Gewinn.