2.23

📡 Sending TradingView Alerts to sTraderZ.com

Turn TradingView alerts into journal entries, signals or watchlist symbols via webhook

1. 🧭 What the Webhook Does

Viele Trader analysieren ihre Charts in TradingView und lassen sich dort per Alert informieren, wenn ein Setup eintritt. Mit dem Webhook schickt TradingView jeden Alert direkt an sTraderZ.com. Du musst nichts doppelt pflegen: Das Setup steht in deinem Journal, bevor du den Trade ausführst, und die Auswertung findet später am selben Ort statt.

Ziel (type)Was passiert
journal (Vorgabe)Ein privater Journal-Eintrag mit Symbol, Kurs, Richtung, Zeiteinheit und deiner Notiz. Kennt sTraderZ.com das Symbol, bekommt der Eintrag einen Link zum Chart. Tags werden zugeordnet und bei Bedarf angelegt.
signalEine Benachrichtigung über deine Signal-Kanäle: Glocke, Push, E-Mail oder Telegram, so wie du sie unter Benachrichtigungen eingestellt hast.
watchlistDas Symbol landet auf einer Watchlist: auf der genannten, sonst auf deiner Standard-Watchlist, sonst auf einer neuen Watchlist „TradingView“.

Die Funktion gehört zu den Signalen und steht ab dem Tarif Premium zur Verfügung. Auf der Seite TradingView-Alerts (Profilmenü) richtest du alles ein.

2. ⚙️ Setting It Up Step by Step

  1. Token anlegen. Auf der Seite TradingView-Alerts gibst du dem Token eine Bezeichnung (z. B. „Swing-Breakouts“) und legst es an. Das Token beginnt mit stz_tv_ und wird nur ein einziges Mal angezeigt. Kopiere es sofort. sTraderZ.com speichert nur eine Prüfsumme und kann es dir später nicht noch einmal zeigen.
  2. Alert in TradingView öffnen. Über das Uhr-Symbol rechts oder per Rechtsklick im Chart („Alert hinzufügen“). Webhooks gibt es bei TradingView erst ab einem kostenpflichtigen Tarif, und TradingView verlangt dafür die Zwei-Faktor-Anmeldung.
  3. Nachricht eintragen. Kopiere eine der Vorlagen von der Einstellungsseite in das Feld „Nachricht“ des Alerts. Direkt nach dem Anlegen zeigt die Seite die Vorlage bereits mit deinem Token.
  4. Webhook-URL eintragen. Unter „Benachrichtigungen“ die Option „Webhook-URL“ aktivieren und die Adresse von der Einstellungsseite einfügen. Sie endet auf /api/webhooks/tradingview.php.
  5. Speichern und prüfen. Sobald der Alert auslöst, erscheint der Aufruf im Empfangsprotokoll auf der Einstellungsseite, mit Link zum angelegten Eintrag oder mit dem Grund der Ablehnung.

Für jeden Zweck ein eigenes Token anzulegen lohnt sich: Im Protokoll siehst du dann, welcher Alert-Satz welchen Aufruf ausgelöst hat, und kannst einzelne Tokens widerrufen, ohne alle Alerts umzustellen. Bis zu zehn Tokens können gleichzeitig aktiv sein.

3. 🧾 The Message: Fields and Templates

TradingView schickt den Text aus dem Feld „Nachricht“ unverändert an sTraderZ.com und ersetzt vorher die Platzhalter in doppelten geschweiften Klammern durch die aktuellen Werte. Beginnt die Nachricht mit {, muss sie gültiges JSON sein, sonst wird der Alert abgelehnt. Jeder andere Text wird als Notiz in einen Journal-Eintrag übernommen; das Token muss dann in der Webhook-URL stehen (?t=…).

{
    "token": "DEIN_TOKEN",
    "type": "journal",
    "symbol": "{{ticker}}",
    "exchange": "{{exchange}}",
    "interval": "{{interval}}",
    "price": "{{close}}",
    "time": "{{timenow}}",
    "action": "{{strategy.order.action}}",
    "note": "Breakout über Widerstand",
    "tags": [
        "breakout",
        "tv-alert"
    ]
}
FeldInhaltRegel
tokendein TokenPflicht, außer es steht in der URL. In der Nachricht ist es besser aufgehoben: Adressen landen in Server-Protokollen, Nachrichten nicht.
typejournal, signal oder watchlistohne Angabe journal
symbol{{ticker}}Buchstaben, Ziffern und . _ - ! / & ^ =, höchstens 40 Zeichen. Ein Börsenpräfix wie NASDAQ:AAPL wird abgetrennt. Pflicht für signal und watchlist.
exchange{{exchange}}hilft, das Symbol eindeutig zuzuordnen
interval{{interval}}Buchstaben und Ziffern, höchstens 10 Zeichen
price{{close}}muss eine Zahl sein
time{{timenow}}höchstens 40 Zeichen
action{{strategy.order.action}}ein Wort, z. B. buy oder sell. TradingView füllt den Platzhalter nur in Strategie-Alerts; bei gewöhnlichen Kursalarmen weglassen. Ein nicht ersetzter Platzhalter wird ignoriert.
notedein Texthöchstens 2.000 Zeichen, HTML wird entfernt
tagsListe, z. B. ["breakout"]höchstens 5 Tags aus Buchstaben, Ziffern, Leerzeichen, - und _
watchlistName einer Watchlistnur bei watchlist; gibt es sie nicht, wird der Alert abgelehnt

Felder, die sTraderZ.com nicht kennt, werden ignoriert. Ein Feld mit falschem Typ (z. B. eine Liste statt Text) führt dagegen zur Ablehnung, damit nichts halb verarbeitet wird.

4. 📋 Reception Log and Error Reasons

Das Empfangsprotokoll auf der Einstellungsseite zeigt die letzten 50 Aufrufe: Zeit, Token, Ziel, Symbol, Ergebnis und den empfangenen Inhalt (das Token darin ist unkenntlich gemacht). Einträge werden nach 30 Tagen gelöscht. Aufrufe mit einem unbekannten oder widerrufenen Token erscheinen nicht, weil sie keinem Nutzer zugeordnet werden können.

Mit Probe-Alert senden über dem Protokoll schickst du einen Beispiel-Alert für AAPL an ein Ziel deiner Wahl. So prüfst du, ob Benachrichtigung, Journal-Eintrag oder Watchlist ankommen, bevor du in TradingView etwas einrichtest. Die Probe erscheint im Protokoll als „Probe-Alert“. Ob die Einrichtung in TradingView stimmt, zeigt erst der erste echte Alert.

GrundBedeutung und Abhilfe
Nachricht beginnt mit { , ist aber kein gültiges JSONMeist fehlt ein Anführungszeichen oder ein Komma. Vorlage neu kopieren.
Ungültiger Wert im Feld …Das genannte Feld passt nicht zur Regel aus dem Abschnitt oben, z. B. ein Kurs mit Text.
Symbol fehltsignal und watchlist brauchen symbol; ein Journal-Eintrag braucht Symbol oder Notiz.
Watchlist mit diesem Namen gibt es nichtName in watchlist prüfen oder das Feld weglassen.
Dein Tarif enthält keine SignaleDer Webhook ist ab Premium verfügbar.
Zu viele Alerts in einer MinuteJe Token werden höchstens 20 Alerts pro Minute verarbeitet. Häufig steckt ein Alert dahinter, der bei jedem Kurs-Tick auslöst; in TradingView „Einmal pro Kerze“ wählen.
Kein Signal-Kanal aktivDer Alert kam an, aber unter Benachrichtigungen ist für Signale kein Kanal eingeschaltet.
Symbol stand schon auf der WatchlistKein Fehler: Ein Symbol wird nicht doppelt aufgenommen.

5. 🔒 Security and Limits

  • Keine Orders, keine Trades. Der Webhook legt nur Journal-Einträge, Benachrichtigungen und Watchlist-Symbole an. Er kann weder Orders auslösen noch Trades oder Positionen ändern.
  • Das Token ist der Schlüssel. TradingView kann weder eigene Header noch Signaturen mitschicken. Wer dein Token kennt, kann deshalb in deinem Namen Alerts schicken. Gib es nicht weiter und widerrufe es sofort, wenn es in falsche Hände geraten ist.
  • Token wechseln. Neues Token anlegen, im Alert eintragen, dann das alte widerrufen. Widerrufene Tokens werden sofort abgelehnt.
  • Grenzen. Höchstens 8 KB je Nachricht, 20 verarbeitete Alerts je Token und Minute, 60 Aufrufe je Absender-Adresse und Minute. TradingView selbst begrenzt Alerts zusätzlich.
  • Privat. Journal-Einträge aus dem Webhook sind immer privat und bringen keine Ranglistenpunkte. Du kannst sie danach wie jeden anderen Eintrag bearbeiten und freigeben.