TradingView-Alarmnachricht: das Format, Beispiel für Beispiel
Die Nachricht ist der einzige Text, den Ihr Alarm sendet. Damit daraus eine Order auf MT4, MT5 oder cTrader wird, folgt sie einem einfachen Format: ein JSON-Objekt oder eine einzige Textzeile. Hier finden Sie jedes Feld, jeden Befehl und kopierfertige Beispiele, alle im Webhook-Tester geprüft.
Die Alarm-Nachricht
{
"action": "buy",
"symbol": "EURUSD",
"volume": 0.10,
"sl": 1.0820,
"tp": 1.0910
}Wohin die Nachricht geht
Im Alarmfenster von TradingView enthält das Feld „Message“ den Text, der bei jedem Auslösen gesendet wird, und das Feld „Webhook URL“ die Adresse, an die er geht. Diese Adresse gehört zu Ihrem TheConnector-Konto: Sie enthält bereits den Zugangsschlüssel, daher beschreibt die Nachricht nur die Order.
- Ein Alarm sendet eine Nachricht, also einen Befehl
- Der Zugangsschlüssel bleibt in der Webhook-Adresse, nie in der Nachricht
- TradingView ersetzt Variablen wie {{ticker}} vor dem Senden
Die minimale Nachricht
Zwei Felder genügen für eine gültige Nachricht: der Befehl und das Symbol. Die Order bezieht ihre Größe dann aus den Risikoeinstellungen des Kontos, und eine risikobasierte Berechnung braucht einen Stop: Ergänzen Sie in der Praxis mindestens einen Stop-Loss oder eine feste Anzahl Lots.
{"action":"buy","symbol":"EURUSD"}
buy,EURUSD- action: was zu tun ist, hier kaufen
- symbol: der TradingView-Ticker, dem Symbol Ihres Brokers zugeordnet
- Die einzeilige Textform enthält genau dieselben Angaben
Die Felder der Nachricht
Acht Felder decken fast jeden Bedarf ab. Ihre Namen werden kleingeschrieben, ihre Werte sind Zahlen, außer bei Befehl, Symbol und Tag. Ein Feld, das TheConnector nicht kennt, wird ohne Meldung ignoriert: Ein falsch geschriebener Name bleibt unbemerkt, deshalb lohnt sich ein Blick in den Tester, bevor Sie live handeln.
actionDer Befehl: kaufen, verkaufen, schließen, stornieren, ändernbuysymbolDas Instrument, wie TradingView es nenntEURUSDriskRisiko der Order, je nach Risikoquelle des Kontos ausgewertet1volumeEine feste Anzahl Lots, die Vorrang vor dem Risiko hat0.10slStop-Loss, im Preismodus des Kontos20tpTake-Profit, im Preismodus des Kontos40priceEinstiegspreis einer Pending-Order1.0850tagName der Strategie, um mehrere auf einem Symbol zu unterscheidentrend- Akzeptierte Aliase: lot oder lots für volume, stoploss für sl, takeprofit für tp
- Kein Feld account: Die Webhook-Adresse bestimmt das Konto bereits
- Weitere Befehle und Einstellungen pro Alarm stehen in der Syntax-Referenz
Die Befehle
Das Feld action enthält einen der folgenden Befehle. Jeder akzeptiert auch eine Schreibweise mit Unterstrich, etwa close_long, und für buy und sell werden auch long und short akzeptiert.
buy / sellEröffnet eine Kauf- oder Verkaufsposition zum Marktpreisbuy,EURUSD,risk=1,sl=20buylimit / selllimitPending-Order unter dem Kurs (Kauf) oder darüber (Verkauf)buylimit,EURUSD,price=1.0850,volume=0.1buystop / sellstopPending-Order über dem Kurs (Kauf) oder darunter (Verkauf)sellstop,GBPJPY,price=198.250,risk=1,sl=198.800closelong / closeshortSchließt die Kauf- oder die Verkaufsposition des Symbolscloselong,EURUSDcloselongshortSchließt beide Richtungen auf dem Symbolcloselongshort,EURUSDcancellong / cancelshortStorniert die Pending-Orders auf der Kauf- oder Verkaufsseitecancelshort,GBPJPYnewsltplong / newsltpshortVerschiebt Stop-Loss und Take-Profit der offenen Positionnewsltplong,EURUSD,sl=15,tp=60- Eine Pending-Order braucht ihren Einstiegspreis
- Ein Schließ- oder Änderungsbefehl nennt das Symbol, wie ein Einstieg
- breakevenlong und breakevenshort sind Aliasse von newsltplong und newsltpshort
Zum Marktpreis kaufen oder verkaufen, mit Stop und Ziel
Die häufigste Nachricht: ein nach dem Risiko bemessener Einstieg zum Marktpreis, mit Stop-Loss und Take-Profit. Mit der Risikoquelle auf „TradingView-Prozentsatz“ und dem Preismodus auf „Pips“ riskiert dieses Beispiel 1 % des Kontostands, mit einem Stop in 20 Pips und einem Ziel in 40 Pips Entfernung.
{"action":"buy","symbol":"EURUSD","risk":1,"sl":20,"tp":40}- Für einen Verkauf ersetzen Sie buy durch sell
- Das Risiko ist der Verlust, wenn der Stop erreicht wird, nicht die Größe der Position
- Für eine feste Größe senden Sie volume statt risk
Eine Pending-Order platzieren
Eine Buy-Limit-Order wartet, bis der Kurs auf ihren Einstieg fällt, eine Buy-Stop-Order, bis er auf ihn steigt. Dieses Beispiel setzt voraus, dass der Preismodus des Kontos auf „Absoluter Preis“ steht: Einstieg, Stop und Ziel sind Marktpreise.
{"action":"buylimit","symbol":"EURUSD","price":1.0850,"volume":0.10,"sl":1.0820,"tp":1.0910}- Hier ist die Größe fest: 0,10 Lot
- Im Modus „Pips“ oder „Prozentsatz“ werden dieselben Felder als Abstände interpretiert
- cancellong entfernt die Pending-Orders auf der Kaufseite, wenn das Setup nicht mehr gilt
Eine Position schließen oder ihren Stop verschieben
Drei Nachrichten, eine pro Alarm: die Kaufposition schließen, beide Richtungen schließen, dann Stop-Loss und Ziel der offenen Kaufposition verschieben. Wie ein Einstieg nennt jede Nachricht ihr Symbol.
{"action":"closelong","symbol":"EURUSD"}
{"action":"closelongshort","symbol":"EURUSD"}
{"action":"newsltplong","symbol":"EURUSD","sl":15,"tp":60}- Ein Schließbefehl ohne Tag trifft die erste Position in der angeforderten Richtung
- Bei mehreren Strategien auf demselben Symbol benennen Sie sie mit tag
- Kopieren Sie eine Zeile pro Alarm, nie den ganzen Block
Zwei Strategien auf demselben Symbol
Ohne Namen trifft ein Schließbefehl die erste Position, die er findet, womöglich die der anderen Strategie. Das Feld tag benennt die Strategie: Beim Einstieg schreibt der Roboter diesen Namen in den Kommentar der Position beim Broker, und ein benannter Schließbefehl betrifft nur die Positionen, die ihn tragen.
{"action":"buy","symbol":"USDJPY","risk":1,"sl":20,"tag":"trend"}
{"action":"closelong","symbol":"USDJPY","tag":"trend"}- Dasselbe Tag in allen Alarmen der Strategie, bei Einstiegen wie Ausstiegen
- Tags werden kleingeschrieben und auf 12 Zeichen gekürzt: Halten Sie sie kurz und unterscheidbar
- Nur Buchstaben, Ziffern, - und _
TradingView-Variablen in die Nachricht einsetzen
Eine einzige Nachricht lässt sich auf allen Charts verwenden: Mit {{ticker}} folgt das Symbol dem Chart, auf dem der Alarm erstellt wird. TradingView ersetzt die Variable vor dem Senden, daher erhält TheConnector das tatsächliche Symbol.
{"action":"buy","symbol":"{{ticker}}","risk":1,"sl":20,"tp":40}- Textvariablen stehen in Anführungszeichen ("{{ticker}}"), Zahlen wie {{close}} nicht
- Strategiealarme: {{strategy.order.action}} lautet beim Ausstieg aus einem Kauf „sell“, nutzen Sie daher besser alert_message
- Die vollständige Liste der Variablen steht im Leitfaden zu TradingView-Alarmen
Die Einheiten von Stop, Ziel und Preis
Die Zahlen in sl, tp und price werden nach dem Preismodus ausgewertet, der in den Kontoeinstellungen gewählt ist. Absoluter Preis: ein Marktpreis, etwa 1.0750. Pips: ein Abstand vom Einstieg, etwa 20. Prozentsatz: ein Abstand in Prozent des Einstiegspreises, etwa 0.5.
- Der Preismodus muss zu dem passen, was Ihre Alarme senden
- Pips eignen sich für Forex; für Indizes und Metalle wählen Sie besser Preis oder Prozentsatz
- Schreiben Sie Dezimalzahlen mit Punkt: In der einzeiligen Form trennt das Komma die Felder
- Variante: sl_pips, sl_price oder sl_pct (und tp_pips, tp_price, tp_pct) legen die Einheit im Alarm selbst fest
Die Fehler, die zur Ablehnung einer Nachricht führen
Die meisten Ablehnungen gehen auf eine Handvoll Ursachen zurück, und der Alarmverlauf nennt jede davon. Die erste überrascht: Ein aus einem alten Beispiel kopiertes Feld account führt dazu, dass der ganze Alarm abgelehnt wird, selbst mit gültigem Schlüssel.
- Ein Feld account, das nicht genau zum Konto passt: Ablehnung wie bei einem abgewiesenen Zugangsschlüssel
- Fehlerhaftes JSON: ein vergessenes Anführungszeichen oder ein Komma zu viel
- Ein unbekannter oder fehlender Befehl oder ein fehlendes Symbol
- Eine Zahl mit Text oder Einheit, etwa 20pips oder 1%
Eine Nachricht vor dem Senden prüfen
Der kostenlose Webhook-Tester liest Ihre Nachricht mit demselben Parser wie das Produktions-Gateway und zeigt, was er versteht: Befehl, Symbol, Größe, Stop, Ziel, Tag. An kein Konto wird etwas gesendet. Der Alarm-Generator auf der Startseite stellt die Nachricht für Sie zusammen.
- Fügen Sie die Nachricht genau so ein, wie sie in TradingView stehen wird
- Ersetzen Sie die Variablen vor dem Test durch echte Werte
- Senden Sie dann einen ersten Alarm an ein Demokonto
Verwandte Guides
FAQ
Gehört der Zugangsschlüssel in die Nachricht?
Nein. Er ist Teil der Webhook-Adresse, die Sie aus Ihrem Dashboard kopieren und die das Konto identifiziert. Die Nachricht beschreibt nur die Order.
JSON oder eine Textzeile: Was sollte man wählen?
Beide werden akzeptiert und enthalten dieselben Felder. JSON benennt jeden Wert und ist dadurch leichter zu überprüfen; die einzeilige Form, etwa buy,EURUSD,risk=1,sl=20,tp=40, ist schneller getippt.
Wie schließt man eine Position per Alarm?
Senden Sie closelong, um die Kaufposition zu schließen, oder closeshort für die Verkaufsposition, mit dem Symbol: {"action":"closelong","symbol":"EURUSD"}. Bei mehreren Strategien auf dem Symbol fügen Sie dasselbe Tag wie beim Einstieg hinzu.
Warum wird mein Alarm abgelehnt, obwohl der Schlüssel gültig ist?
Meist wegen eines Feldes account, das aus einem alten Beispiel kopiert wurde: Ist es vorhanden, muss es genau zum Konto passen, sonst wird der Alarm abgelehnt, als wäre der Schlüssel falsch. Entfernen Sie es, die Webhook-Adresse genügt.
Kann man den Schlusskurs der Kerze senden?
Ja, mit der Variable {{close}}, ohne Anführungszeichen. Sie dient als Einstiegspreis einer Pending-Order, wenn der Preismodus des Kontos auf „Absoluter Preis“ steht.
Was passiert, wenn die Nachricht ein Feld enthält, das TheConnector nicht kennt?
Es wird ignoriert, ohne Fehlermeldung. Die Order wird ohne dieses Feld gesendet: Ein falsch geschriebener Name ändert die Order also ohne Warnung. Prüfen Sie die Nachricht im Webhook-Tester.