TradingView-Alarmnachricht: das Format, Beispiel für Beispiel

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

Neun Felder decken fast jeden Bedarf ab. Groß- und Kleinschreibung spielt bei ihren Namen keine Rolle; ihre Werte sind Zahlen, außer bei Befehl, Symbol, Einheit 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.

• ✓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.

• ✓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. priceMode nennt die Einheit im Alarm selbst, daher funktioniert das Beispiel unabhängig vom Preismodus des Kontos: Mit der Risikoquelle auf „TradingView-Prozentsatz“, der Standardeinstellung, riskiert es 1 % des Kontostands, mit einem Stop 0,2 % vom Einstieg und einem Ziel in 0,4 % Entfernung.

{"action":"buy","symbol":"EURUSD","risk":1,"sl":0.2,"tp":0.4,"priceMode":"percent"}

• ✓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
• ✓Bei EURUSD entsprechen 0,2 % etwa 20 Pips; dieselbe Nachricht funktioniert auch bei Gold oder einem Index

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. Hier legt priceMode price fest, dass Einstieg, Stop und Ziel Marktpreise sind, unabhängig vom Preismodus des Kontos.

{"action":"buylimit","symbol":"EURUSD","price":1.0850,"volume":0.10,"sl":1.0820,"tp":1.0910,"priceMode":"price"}

• ✓Hier ist die Größe fest: 0,10 Lot
• ✓Mit priceMode pips oder percent 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":0.15,"tp":0.6,"priceMode":"percent"}

• ✓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":0.2,"priceMode":"percent","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":0.2,"tp":0.4,"priceMode":"percent"}

• ✓Textvariablen stehen in Anführungszeichen ("{{ticker}}"), Zahlen wie {{close}} nicht
• ✓In Prozent passen derselbe Stop und dasselbe Ziel zu jedem Chart, unabhängig vom Instrument
• ✓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 in der Einheit von priceMode ausgewertet, sonst nach dem Preismodus, der in den Kontoeinstellungen gewählt ist. Absoluter Preis (price): ein Marktpreis, etwa 1.0750. Pips: ein Abstand vom Einstieg, etwa 20. Prozentsatz (percent): ein Abstand in Prozent des Einstiegspreises, etwa 0.5.

• ✓Ohne priceMode muss der Preismodus des Kontos 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: Ein Suffix (sl_pips, tp_price, entry_pct…) legt nur die Einheit seines eigenen Werts fest; ein Alarm, dessen Preise zwei Einheiten verlangen, wird abgelehnt

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