Messaggio di alert TradingView: il formato, esempio per esempio
Il messaggio è l'unico testo che il tuo alert invia. Per diventare un ordine su MT4, MT5 o cTrader, segue un formato semplice: un oggetto JSON o una sola riga di testo. Ecco ogni campo, ogni comando ed esempi pronti da copiare, tutti verificati nel tester webhook.
Il messaggio dell'alert
{
"action": "buy",
"symbol": "EURUSD",
"volume": 0.10,
"sl": 1.0820,
"tp": 1.0910
}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 tuo 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, aggiungi 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 tuo broker
- La forma testo su una riga contiene esattamente le stesse informazioni
I campi del messaggio
Otto campi coprono quasi tutte le esigenze. I loro nomi si scrivono in minuscolo, i loro valori sono numeri, tranne il comando, il simbolo 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.
actionIl comando: acquistare, vendere, chiudere, annullare, modificarebuysymbolLo strumento, come lo chiama TradingViewEURUSDriskRischio dell'ordine, letto in base alla fonte del rischio del conto1volumeUn numero fisso di lotti, che ha la precedenza sul rischio0.10slStop-loss, nella modalità prezzo del conto20tpTake-profit, nella modalità prezzo del conto40pricePrezzo d'ingresso di un ordine pendente1.0850tagNome della strategia, per distinguerne più d'una sullo stesso simbolotrend- 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.
buy / sellApre una posizione a mercato, in acquisto o in venditabuy,EURUSD,risk=1,sl=20buylimit / selllimitOrdine pendente sotto il prezzo (acquisto) o sopra (vendita)buylimit,EURUSD,price=1.0850,volume=0.1buystop / sellstopOrdine pendente sopra il prezzo (acquisto) o sotto (vendita)sellstop,GBPJPY,price=198.250,risk=1,sl=198.800closelong / closeshortChiude la posizione in acquisto o in vendita del simbolocloselong,EURUSDcloselongshortChiude entrambe le direzioni sul simbolocloselongshort,EURUSDcancellong / cancelshortAnnulla gli ordini pendenti in acquisto o in venditacancelshort,GBPJPYnewsltplong / newsltpshortSposta lo stop-loss e il take-profit della posizione apertanewsltplong,EURUSD,sl=15,tp=60- 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. Con la fonte del rischio su «Percentuale di TradingView» e la modalità prezzo su «Pips», questo esempio rischia l'1% del saldo, con uno stop a 20 pip e un target a 40 pip.
{"action":"buy","symbol":"EURUSD","risk":1,"sl":20,"tp":40}- Per una vendita, sostituisci buy con sell
- Il rischio è la perdita se lo stop viene raggiunto, non la dimensione della posizione
- Per imporre una dimensione, invia volume al posto di risk
Piazzare un ordine pendente
Un buy limit attende che il prezzo ridiscenda fino al suo ingresso, un buy stop che salga fino a raggiungerlo. Questo esempio presuppone la modalità prezzo del conto su «Prezzo assoluto»: l'ingresso, lo stop e il target sono prezzi di mercato.
{"action":"buylimit","symbol":"EURUSD","price":1.0850,"volume":0.10,"sl":1.0820,"tp":1.0910}- Qui la dimensione è fissa: 0,10 lotti
- In modalità «Pips» o «Percentuale», 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":15,"tp":60}- Una chiusura senza tag prende la prima posizione nella direzione richiesta
- Con più strategie sullo stesso simbolo, dai loro un nome con tag
- Copia 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":20,"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: tienili 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":20,"tp":40}- Le variabili di testo vanno tra virgolette ("{{ticker}}"), i numeri come {{close}} no
- Alert di strategia: {{strategy.order.action}} dice «sell» per uscire da un acquisto, quindi preferisci 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 in base alla modalità prezzo scelta nelle impostazioni del conto. Prezzo assoluto: un prezzo di mercato, come 1.0750. Pips: una distanza dall'ingresso, come 20. Percentuale: una distanza in percentuale del prezzo d'ingresso, come 0.5.
- La modalità prezzo deve corrispondere a ciò che inviano i tuoi alert
- I pip vanno bene per il forex; su indici e metalli, preferisci il prezzo o la percentuale
- Scrivi i decimali con il punto: nella forma su una riga, la virgola separa i campi
- Variante: sl_pips, sl_price o sl_pct (e tp_pips, tp_price, tp_pct) fissano l'unità nell'alert stesso
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 tuo 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 te.
- Incolla il messaggio esattamente come sarà in TradingView
- Sostituisci le variabili con valori reali prima del test
- Poi invia un primo alert verso un conto demo
Guide correlate
FAQ
Bisogna mettere la chiave di accesso nel messaggio?
No. Fa parte dell'indirizzo del webhook copiato dalla tua dashboard, che identifica il conto. Il messaggio descrive solo l'ordine.
JSON o una riga di testo: quale scegliere?
Entrambi sono accettati e contengono gli stessi campi. Il JSON dà un nome a ogni valore, il che lo rende più facile da rileggere; la forma su una riga, come buy,EURUSD,risk=1,sl=20,tp=40, è più breve da digitare.
Come si chiude una posizione da un alert?
Invia closelong per chiudere la posizione in acquisto o closeshort per quella in vendita, con il simbolo: {"action":"closelong","symbol":"EURUSD"}. Con più strategie sul simbolo, aggiungi lo stesso tag dell'ingresso.
Perché il mio alert viene rifiutato anche se la chiave è valida?
Il più delle volte per un campo account copiato da un vecchio esempio: se è presente, deve corrispondere esattamente al conto, altrimenti l'alert viene rifiutato come se la chiave fosse sbagliata. Rimuovilo, l'indirizzo del webhook basta.
Si può inviare il prezzo di chiusura della candela?
Sì, con la variabile {{close}}, senza virgolette. Serve come prezzo d'ingresso di un ordine pendente, quando la modalità prezzo del conto è «Prezzo assoluto».
Cosa succede se il messaggio contiene un campo che TheConnector non conosce?
Viene ignorato, senza segnalare errori. L'ordine parte senza di esso: un nome scritto male cambia quindi l'ordine senza avvisare. Verifica il messaggio nel tester webhook.