Payload webhook TradingView

Obiettivo

Questa pagina documenta il contratto pubblico WebhookIngress per gli alert TradingView. Non è il payload degli ordini manuali dalla dashboard.

Percorso di accesso

• Nell'area clienti: Account > aprire un conto di trading > copiare la chiave di accesso.
• In TradingView: Alert > Notifications > incollare https://webhook.theconnector.fr/YOUR_ACCESS_KEY in Webhook URL.
• Nel campo Message di TradingView, incollare il JSON.

JSON minimo

{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 20,
  "tp": 40
}

Campi letti da WebhookIngress

• action è obbligatorio. Alias: side, type, command, msgtype.
• symbol è obbligatorio per i comandi trading. Alias: pair, ticker, instrument, market, asset.
• risk viene passato come rischio numerico. Per lotti esatti usa volume, lot, lots o fixedVolume.
• sl e tp sono i nomi attuali per stop loss / take profit. Alias: stoploss, stop_loss, takeprofit, take_profit.
• price serve solo per ordini pendenti: buystop, buylimit, sellstop, selllimit.
• ticket, orderId, order_id, positionId o position_id servono solo quando si punta a un ordine o posizione nota.
• account / accountCode e platform sono opzionali con l'URL account; servono solo in setup di routing condiviso.
• streamId o id può essere inviato per il tracciamento. Se manca, il server crea un id.
• tag (alias comment) dà il nome alla strategia a cui appartiene l'avviso. In un ingresso viene scritto nel commento della posizione presso il broker; in una chiusura limita la chiusura alle posizioni che portano quel nome, così più strategie possono condividere un conto e un simbolo. Viene reso minuscolo e tagliato a 12 caratteri, ed è rispettato dal robot 0.0.21 in poi — sotto quella versione una chiusura con nome viene rifiutata invece di essere eseguita sulla posizione di un'altra strategia. Se invii un tuo streamId, sostituisce quello generato e il nome non raggiunge mai il commento della posizione: ometti streamId quando usi i nomi.
• clientRequestedAtUtc, requestedAtUtc o requestedAt possono essere inviati come timestamp UTC informativo.

Alternativa su una riga

JSON è consigliato, ma WebhookIngress accetta anche testo separato da virgole:

buy,EURUSD,risk=1,sl=20,tp=40

Cosa non inviare

Non fare affidamento su ttl_ms, vol_lots, sl_pips o tp_pips: il parser WebhookIngress attuale non legge questi nomi. Usa la modalità prezzo dell'account per interpretare sl, tp e price.

Script di terze parti esistenti

Non dare per scontato che un messaggio creato per un altro connettore sia compatibile senza modifiche. Puoi mantenere la logica della strategia, ma verifica e adatta i campi TradingView sopra.