Messaggio di alert TradingView: il formato, esempio per esempio

Dove va il messaggio

Nella finestra dell'alert di TradingView, il campo «Message» contiene il testo inviato ogni volta che l'alert scatta, e il campo «Webhook URL» l'indirizzo verso cui parte. Questo indirizzo è quello del suo conto TheConnector: contiene già la chiave di accesso, quindi il messaggio descrive solo l'ordine.

• ✓Un alert invia un messaggio, quindi un comando
• ✓La chiave di accesso resta nell'indirizzo del webhook, mai nel messaggio
• ✓TradingView sostituisce le variabili come {{ticker}} prima dell'invio

Il messaggio minimo

Due campi bastano per un messaggio valido: il comando e il simbolo. L'ordine ricava allora la sua dimensione dalle impostazioni di rischio del conto, e un calcolo basato sul rischio ha bisogno di uno stop: in pratica, aggiunga almeno uno stop-loss, oppure un numero fisso di lotti.

{"action":"buy","symbol":"EURUSD"}

buy,EURUSD

• ✓action: cosa fare, qui acquistare
• ✓symbol: il ticker TradingView, abbinato al simbolo del suo broker
• ✓La forma testo su una riga contiene esattamente le stesse informazioni

I campi del messaggio

Nove campi coprono quasi tutte le esigenze. Maiuscole e minuscole non contano nei loro nomi; i loro valori sono numeri, tranne il comando, il simbolo, l'unità e il tag. Un campo che TheConnector non conosce viene ignorato senza alcun avviso: un nome scritto male passa inosservato, per questo conviene usare il tester prima di passare al conto reale.

• ✓Alias accettati: lot o lots per volume, stoploss per sl, takeprofit per tp
• ✓Nessun campo account: l'indirizzo del webhook indica già il conto
• ✓Altri comandi e impostazioni per singolo alert sono nel riferimento della sintassi

I comandi

Il campo action contiene uno dei comandi qui sotto. Ognuno accetta anche una grafia con il trattino basso, come close_long, e per buy e sell sono accettati anche long e short.

• ✓Un ordine pendente ha bisogno del suo prezzo d'ingresso
• ✓Una chiusura o una modifica indica il simbolo, come un ingresso
• ✓breakevenlong e breakevenshort sono alias di newsltplong e newsltpshort

Acquistare o vendere a mercato, con stop e target

Il messaggio più comune: un ingresso a mercato dimensionato in base al rischio, con il suo stop-loss e il suo take-profit. priceMode indica l'unità nell'alert stesso, quindi l'esempio funziona qualunque sia la modalità prezzo del conto: con la fonte del rischio su «Percentuale di TradingView», l'impostazione predefinita, rischia l'1% del saldo, con uno stop allo 0,2% dall'ingresso e un target allo 0,4%.

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

• ✓Per una vendita, sostituisca buy con sell
• ✓Il rischio è la perdita se lo stop viene raggiunto, non la dimensione della posizione
• ✓Per imporre una dimensione, invii volume al posto di risk
• ✓Su EURUSD, lo 0,2% vale circa 20 pip; lo stesso messaggio funziona anche sull'oro o su un indice

Piazzare un ordine pendente

Un buy limit attende che il prezzo ridiscenda fino al suo ingresso, un buy stop che salga fino a raggiungerlo. Qui priceMode price indica che l'ingresso, lo stop e il target sono prezzi di mercato, qualunque sia la modalità prezzo del conto.

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

• ✓Qui la dimensione è fissa: 0,10 lotti
• ✓Con priceMode pips o percent, gli stessi campi si leggono come distanze
• ✓cancellong rimuove gli ordini pendenti in acquisto se il setup non è più valido

Chiudere una posizione o spostarne lo stop

Tre messaggi, uno per alert: chiudere la posizione in acquisto, chiudere entrambe le direzioni, poi spostare lo stop-loss e il target della posizione in acquisto aperta. Come un ingresso, ognuno indica il proprio simbolo.

{"action":"closelong","symbol":"EURUSD"}
{"action":"closelongshort","symbol":"EURUSD"}
{"action":"newsltplong","symbol":"EURUSD","sl":0.15,"tp":0.6,"priceMode":"percent"}

• ✓Una chiusura senza tag prende la prima posizione nella direzione richiesta
• ✓Con più strategie sullo stesso simbolo, dia loro un nome con tag
• ✓Copi una riga per alert, mai l'intero blocco

Due strategie sullo stesso simbolo

Senza nome, una chiusura prende la prima posizione che trova, magari quella dell'altra strategia. Il campo tag dà un nome alla strategia: in ingresso, il robot lo scrive nel commento della posizione presso il broker, e una chiusura con nome tocca solo le posizioni che lo portano.

{"action":"buy","symbol":"USDJPY","risk":1,"sl":0.2,"priceMode":"percent","tag":"trend"}
{"action":"closelong","symbol":"USDJPY","tag":"trend"}

• ✓Lo stesso tag in tutti gli alert della strategia, sia in ingresso sia in uscita
• ✓I tag vengono resi minuscoli e tagliati a 12 caratteri: li tenga corti e distinti
• ✓Solo lettere, cifre, - e _

Inserire variabili TradingView nel messaggio

Un solo messaggio può servire per tutti i grafici: con {{ticker}}, il simbolo segue il grafico su cui viene creato l'alert. TradingView sostituisce la variabile prima dell'invio, quindi TheConnector riceve il simbolo reale.

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

• ✓Le variabili di testo vanno tra virgolette ("{{ticker}}"), i numeri come {{close}} no
• ✓In percentuale, lo stesso stop e lo stesso target vanno bene per ogni grafico, qualunque sia lo strumento
• ✓Alert di strategia: {{strategy.order.action}} dice «sell» per uscire da un acquisto, quindi preferisca alert_message
• ✓L'elenco completo delle variabili è nella guida agli alert TradingView

Le unità dello stop, del target e del prezzo

I numeri di sl, tp e price si leggono nell'unità indicata da priceMode o, in mancanza, in base alla modalità prezzo scelta nelle impostazioni del conto. Prezzo assoluto (price): un prezzo di mercato, come 1.0750. Pips: una distanza dall'ingresso, come 20. Percentuale (percent): una distanza in percentuale del prezzo d'ingresso, come 0.5.

• ✓Senza priceMode, la modalità prezzo del conto deve corrispondere a ciò che inviano i suoi alert
• ✓I pip vanno bene per il forex; su indici e metalli, preferisca il prezzo o la percentuale
• ✓Scriva i decimali con il punto: nella forma su una riga, la virgola separa i campi
• ✓Variante: un suffisso (sl_pips, tp_price, entry_pct…) fissa solo l'unità del proprio valore; un alert i cui prezzi chiedono due unità viene rifiutato

Gli errori che fanno rifiutare un messaggio

La maggior parte dei rifiuti deriva da una manciata di cause, e lo storico degli alert le indica una per una. La prima sorprende: un campo account copiato da un vecchio esempio fa rifiutare l'intero alert, anche con una chiave valida.

• ✓Un campo account che non corrisponde esattamente al conto: rifiuto come per una chiave di accesso respinta
• ✓JSON malformato: una virgoletta dimenticata o una virgola di troppo
• ✓Un comando sconosciuto o assente, o un simbolo mancante
• ✓Un numero accompagnato da testo o da un'unità, come 20pips o 1%

Verificare un messaggio prima di inviarlo

Il tester webhook gratuito legge il suo messaggio con lo stesso parser del gateway di produzione e mostra ciò che capisce: comando, simbolo, dimensione, stop, target, tag. Nulla viene inviato ad alcun conto. Il generatore di alert della home page compone il messaggio per lei.

• ✓Incolli il messaggio esattamente come sarà in TradingView
• ✓Sostituisca le variabili con valori reali prima del test
• ✓Poi invii un primo alert verso un conto demo