Alert-Syntax

Die Alert-Syntax ist das exakte Textformat, in dem eine Signalquelle einen Trade beschreibt, zum Beispiel die JSON-Nachricht, die ein TradingView-Alert an einen Webhook sendet, oder das Schlüsselwortmuster, dem ein Telegram-Kanal folgt; die empfangende Plattform zerlegt diese Syntax in Symbol, Richtung, Einstieg, Stop-Loss und Take-Profit.

Warum es wichtig ist

Automatisierung funktioniert nur, wenn Absender und Empfänger sich auf das Format einigen. TradingView lässt Sie eine beliebige Nachricht schreiben und füllt Platzhalter wie den Ticker und den Schlusskurs zum Zeitpunkt des Alerts aus; sagt die Nachricht nicht, in welche Richtung gehandelt werden soll, oder verwendet sie einen Feldnamen, den der Empfänger nicht kennt, kommt der Alert an und nichts passiert. Der TradingView-Standardtext ("BTCUSDT Crossing 60000") enthält überhaupt keine Richtung. Bei Telegram gibt es keinen Standard, sodass die Syntax das ist, was der Kanal gewohnheitsmäßig schreibt, und schon kleine Änderungen dieser Gewohnheit können das Parsing zum Scheitern bringen.

So geht AlgoVesta damit um

Für TradingView stellt AlgoVesta pro Strategie eine fertige JSON-Vorlage mit bereits eingesetzten Platzhaltern bereit: Symbol aus dem Ticker, Seite, ein Einstiegshinweis aus dem Schlusskurs sowie optionale Stop-Loss- und Take-Profit-Werte aus Plots oder festen Werten. Die Vorlage wird im Dashboard erzeugt und kann unverändert in das Nachrichtenfeld des Alerts kopiert werden. Felder, die Sie nicht senden, fallen auf die eigenen Regeln des Bots zurück, etwa einen festen Stop in Prozent. Alerts, deren Text sich nicht in eine Richtung übersetzen lässt, werden mit dem Grund als abgelehnt erfasst, statt geraten zu werden. Bei Telegram erkennt der Parser gängige Schlüsselwort-Layouts, Emoji-Markierungen, Ziellisten und Stop-Notationen, und jeder Kanal kann im Paper-Modus (Demo) getestet werden, um Nachricht für Nachricht zu sehen, was extrahiert wurde. Die Dokumentation finden Sie auf der Seite TradingView-Bot und im Leitfaden zur Webhook-Einrichtung.

Beispiel

Eine TradingView-Strategie ist mit der Nachricht {"symbol":"{{ticker}}","side":"{{strategy.order.action}}","price":{{close}},"stop_loss":{{plot_0}},"take_profit":{{plot_1}},"market_position":"{{strategy.market_position}}"} konfiguriert. Wenn bei ETHUSDT ein Long-Einstieg auslöst, sendet TradingView das ausgefüllte JSON an die Webhook-URL der Strategie; AlgoVesta liest die Seite "buy", den Einstiegshinweis und die beiden Plot-Werte und eröffnet die Position mit diesen Kursen. Ein zweiter Alert mit dem Standardtext "ETHUSDT Crossing 3100" wird abgelehnt, da keine Richtung erkennbar ist.

Häufige Fehler

• Den TradingView-Standard-Alerttext unverändert lassen.
• Für Ausstiege allein strategy.order.action verwenden, sodass ein "sell", das eine Long-Position schließen soll, stattdessen eine Short-Position eröffnet; den Positionsstatus einbeziehen oder die Exit-Handhabung der Plattform nutzen.
• Das JSON von Hand bearbeiten und dabei ein Anführungszeichen oder ein Komma zerstören, wodurch die gesamte Nachricht nicht mehr auswertbar ist.
• Den Alert auf einem anderen Chart anlegen als dem Symbol, das eigentlich gehandelt werden soll, sodass der Ticker-Platzhalter das falsche Symbol einsetzt.