TradingView-Webhook-Payload - Leitfaden

Zweck

Diese Seite dokumentiert den öffentlichen WebhookIngress-Vertrag für TradingView-Alarme. Es ist nicht der Payload für manuelle Dashboard-Orders.

Zugriffspfad

Im Kundenbereich: Meine Konten > Trading-Konto öffnen > Zugriffsschlüssel kopieren.
In TradingView: Alarm > Benachrichtigungen > https://webhook.theconnector.fr/YOUR_ACCESS_KEY in Webhook URL einfügen.
In das TradingView-Feld Message die Nachricht einfügen: JSON oder eine Zeile, ganz nach Wunsch.

Screenshot der Kontoeinstellungen — Öffnen Sie die Kontodetails und kopieren Sie Konto-Code oder Zugriffsschlüssel aus dem echten Dashboard.

Zwei Formate, dasselbe Ergebnis

WebhookIngress liest zwei Nachrichtenformate und behandelt sie genau gleich: ein JSON-Objekt oder eine einzelne Textzeile. Nutzen Sie das Format, das Ihnen lieber ist. In einer Zeile stehen Aktion und Symbol vorne, danach die übrigen Felder als name=wert, durch Kommas getrennt.

Minimales JSON

json

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

priceMode legt die Einheit von sl, tp und price im Alarm selbst fest: price, pips oder percent. Hier liegt der Stop 0,2 % vom Einstieg und das Ziel 0,4 % entfernt, unabhängig vom Preismodus des Kontos; ohne priceMode gilt der Preismodus des Kontos.

Von WebhookIngress gelesene Felder

action ist erforderlich. Aliase, in JSON wie in einer Zeile: side, type, command, msgtype. type nennt den Befehl, keine Orderart: buy mit type=limit ergibt zwei verschiedene Befehle, und der Alarm wird abgelehnt — eine Pending Order hat ihren eigenen Befehl, buylimit, selllimit, buystop oder sellstop, mit ihrem Einstiegskurs in price.
symbol ist für Trading-Befehle erforderlich. Aliase: pair, ticker, instrument, market, asset.
risk wird als numerischer Risikowert übertragen. Für feste Lots nutzen Sie volume, lot, lots, fixedVolume oder size.
sl und tp sind die aktuellen Namen für Stop Loss / Take Profit. Aliase: stoploss, stop_loss, takeprofit, take_profit.
price gilt nur für Pending Orders: buystop, buylimit, sellstop, selllimit.
expiration (Alias expiry) gibt einer Pending Order eine Laufzeit in Minuten: Der Broker löscht sie, wenn sie bis dahin nicht ausgelöst wurde, auch bei ausgeschaltetem Roboter. Beispiel: "expiration": 60. Bei Market Orders wird es ignoriert. Es erfordert Roboter 0.0.30 oder neuer: Mit einem älteren Roboter wird der Alert abgelehnt, statt die Order unbegrenzt liegen zu lassen. Akzeptiert der Broker für dieses Symbol keinen Ablauf, wird die Order abgelehnt und nie ohne ihn platziert.
priceMode legt die Einheit von sl, tp und price für diesen Alarm fest: price, pips oder percent. Ohne das Feld gilt der Preismodus des Kontos.
ticket, orderId, order_id, positionId oder position_id gelten nur bei einer bekannten Order oder Position.
account / accountCode und platform sind mit der Konto-URL optional; sie sind nur für geteiltes Routing nützlich.
streamId oder id kann zur Nachverfolgung gesendet werden. Der Server übernimmt es in seine eigene ID, mit vorangestelltem TV- (höchstens 17 Zeichen, Bindestriche werden zu _), gefolgt von _ und 8 Zeichen. Zwei Alarme mit derselben ID sind daher zwei getrennte Alarme: Der zweite wird nie als Duplikat behandelt. Fehlt es, erzeugt der Server eine ID.
tag (Alias comment) benennt die Strategie, zu der ein Alert gehört. Bei einem Einstieg wird er in den Broker-Kommentar der Position geschrieben; bei einem Schließen begrenzt er das Schließen auf die Positionen mit diesem Namen, sodass mehrere Strategien ein Konto und ein Symbol teilen können. Er wird kleingeschrieben und auf 12 Zeichen gekürzt und ab Roboter 0.0.21 berücksichtigt — darunter wird ein benanntes Schließen abgelehnt, statt auf der Position einer anderen Strategie ausgeführt zu werden. Senden Sie eine eigene streamId, ersetzt sie die erzeugte und der Name erreicht den Positionskommentar nie: lassen Sie streamId weg, wenn Sie Namen verwenden.
clientRequestedAtUtc, requestedAtUtc oder requestedAt können als informative UTC-Zeit gesendet werden.

Dieselbe Nachricht in einer Zeile

Dieselbe Order wie oben, in einer einzigen Zeile geschrieben:

text

buy,EURUSD,risk=1,sl=0.2,tp=0.4,priceMode=percent

Nicht senden

Verlassen Sie sich nicht auf ttl_ms: der aktuelle WebhookIngress-Parser liest es nicht. vol_lots wird als volume gelesen. Jeder Preis behält die Einheit, in der er geschrieben ist: Ein Suffix legt die Einheit nur dieses Werts fest (sl_pips, sl_price, sl_pct, tp_pips, tp_price, tp_pct sowie entry_pips, entry_price, entry_pct für den Einstieg einer Pending Order); sl, tp und price ohne Suffix nehmen den im Alarm geschriebenen priceMode (oder unit), sonst den Preis-Modus des Kontos. Der Roboter wendet eine einzige Einheit auf die ganze Order an: Ein Alarm, dessen Preise zwei Einheiten verlangen, wird daher abgelehnt und nie ohne seinen Stop-Loss oder Take-Profit gesendet — sl_pips mit tp_price oder sl ohne Suffix neben tp_pips (auch auf einem Konto im Pips-Modus; ergänzen Sie priceMode=pips). Setzen Sie ein Suffix an alle Preise oder an keinen. Ein Alarm, der dasselbe Feld zweimal mit zwei verschiedenen Werten schreibt, wird ebenfalls abgelehnt (sl=10 und dann sl=20 oder "type":"sell" mit "action":"buy"); derselbe Wert zweimal zählt einmal.

Für WebhookTrade geschriebene Alarme

Ein Alarm im WebhookTrade-Format wird für symbol, action (buy_limit, sell_stop…), price, stop_loss, take_profit, size (Lots) und expiration (Minuten) unverändert gelesen; comment benennt die Strategie, wie tag; username, api_key, broker und account_type werden ignoriert. Von den Schließ-Aktionen wird close_all als closeall gelesen; statt close_buy, close_sell und close_pending senden Sie closelong, closeshort oder cancellong und cancelshort. Ihre übrigen Parameter für Stop, Ziel, Größe, Trailing und Break-even — sl_percentage, tp_percentage, sl_distance, tp_distance, sl_distance_price, tp_distance_price, stop_amount, profit_amount, size_percentage, risk_percentage, size_multiplier, ts_…, breakeven_… — führen zur Ablehnung des Alarms, mit einer Meldung, die sie nennt: ohne sie ausgeführt, würde die Order ohne ihren Stop oder mit einer anderen Größe gesendet. Schreiben Sie sie mit sl / tp und priceMode, volume oder risk sowie betrigger / trailtrig / traildist.

Sie haben schon Alarme? Behalten Sie sie

Sie müssen Ihre Alarme nicht neu schreiben. Eine einzeilige Nachricht funktioniert unverändert, auch wenn sie mit einer Lizenz-ID beginnt: Ersetzen Sie in jedem TradingView-Alarm nur die Webhook-URL durch Ihre eigene, die mit Ihrem Zugriffsschlüssel endet. Der Wert vor dem Befehl wird dann ignoriert, und Parameternamen wie sl_pips, tp_price oder vol_lots werden automatisch übersetzt. Eine Ausnahme: Ein Alarm, der Preiseinheiten mischt (etwa sl_pips mit tp_price), wird jetzt abgelehnt: Schreiben Sie alle Preise in derselben Einheit.