Alertas do TradingView: o guia completo
Um alerta do TradingView vigia uma condição no seu gráfico — um preço, um indicador, uma estratégia — e avisa assim que ela se verifica. Este guia cobre toda a cadeia: criar o alerta, escolher a frequência e a expiração, escrever a mensagem com as variáveis do TradingView e, por fim, fazer com que seja executada em MT4, MT5 ou cTrader.
A mensagem do alerta
{
"action": "buy",
"symbol": "EURUSD",
"volume": 0.10,
"sl": 1.0820,
"tp": 1.0910
}O que é um alerta do TradingView
Um alerta combina uma condição, uma frequência de disparo, uma data de expiração e uma ou várias notificações. Funciona nos servidores do TradingView, não no seu navegador: depois de criado, dispara mesmo com o computador desligado. O número de alertas ativos que pode manter depende do seu plano TradingView.
- Condição: um preço, um indicador, uma estratégia Pine Script ou um desenho
- Disparo: uma só vez, todas as vezes, no fecho da vela ou uma vez por minuto
- Notificações: aplicação, pop-up, e-mail, som ou webhook
Criar um alerta, parâmetro a parâmetro
Abra a janela de alerta com o botão Alerta (o relógio da barra superior), o atalho Alt + A ou um clique com o botão direito no gráfico. Escolha primeiro a condição: o símbolo cruza um preço, um indicador atravessa um nível ou uma estratégia executa uma ordem. Depois, defina a frequência e a expiração, dê um nome ao alerta, escreva a sua mensagem e marque as notificações pretendidas no separador Notifications.
- Expiração: uma data precisa, ou sem fim (opção ausente nos alertas de lista de observação)
- Nome: é ele que aparece no registo e nas notificações
- Message: texto livre, onde o TradingView substitui as variáveis no disparo
Que frequência escolher para uma ordem automática
Um alerta de preço só oferece duas opções: uma só vez, ou todas as vezes. Um alerta de indicador ou de estratégia oferece mais, entre as quais «uma vez no fecho da vela». Para colocar ordens, é a opção mais segura: o sinal fica confirmado quando a vela fecha, ao passo que, a meio da vela, um cruzamento pode aparecer e depois desaparecer. O TradingView só dispara um alerta no fecho se a condição ainda for verdadeira nesse momento.
- No fecho da vela: sinal confirmado, a opção a privilegiar para negociar
- Todas as vezes: mais reativa, mas um sinal pode apagar-se antes do fecho
- Uma só vez: o alerta desativa-se após o primeiro disparo
A mensagem do alerta e as suas variáveis
O campo Message é texto livre. No momento em que o alerta dispara, o TradingView substitui nele cada variável escrita entre chavetas duplas pelo seu valor: o símbolo, o preço de fecho da vela, a hora. É isso que permite escrever uma única mensagem que se mantém correta em qualquer gráfico.
{{ticker}}O símbolo do gráficoEURUSD{{exchange}}O mercado onde o símbolo é cotadoOANDA{{close}}O preço de fecho da vela do disparo1.08425{{open}} {{high}} {{low}}Abertura, máximo e mínimo dessa vela1.08390{{volume}}O volume da vela1532{{interval}}A unidade de tempo do gráfico15{{time}}A hora da vela, em UTC2026-09-23T14:15:00Z{{timenow}}A hora do disparo, em UTC2026-09-23T14:29:07Z{{plot_0}}A primeira curva do indicador71.4{{syminfo.currency}}A moeda de cotaçãoUSD- Os valores são os da vela que disparou o alerta
- {{time}} e {{timenow}} estão sempre em UTC
- Até 20 curvas de indicador: de {{plot_0}} a {{plot_19}}
As variáveis das estratégias Pine Script
Um alerta colocado numa estratégia dispara a cada ordem da estratégia e dispõe de variáveis adicionais. Atenção à armadilha: {{strategy.order.action}} vale «sell» tanto para abrir uma venda como para fechar uma compra; enviado tal como está, a saída de uma compra abriria uma venda. O método seguro: escrever o comando exato no parâmetro alert_message de cada ordem da estratégia e pôr {{strategy.order.alert_message}} como mensagem do alerta.
{{strategy.order.action}}«buy» ou «sell», tanto para as entradas como para as saídassell{{strategy.order.contracts}}A quantidade da ordem, nas unidades da estratégia10000{{strategy.order.price}}O preço de execução da ordem1.08425{{strategy.market_position}}A posição da estratégia: long, flat ou shortflat{{strategy.order.alert_message}}O texto passado a alert_message{"action":"closelong",…}//@version=6
strategy("Moving average crossover", overlay = true)
fast = ta.sma(close, 20)
slow = ta.sma(close, 50)
if ta.crossover(fast, slow)
strategy.entry("L", strategy.long, alert_message = '{"action":"buy","symbol":"' + syminfo.ticker + '","risk":1}')
if ta.crossunder(fast, slow)
strategy.close("L", alert_message = '{"action":"closelong","symbol":"' + syminfo.ticker + '"}')- Mensagem do alerta: {{strategy.order.alert_message}}, mais nada
- Um comando por ordem: buy para entrar, closelong para sair
- {{strategy.order.contracts}} é uma quantidade da estratégia, não um lote MetaTrader
Receber o alerta: notificações e webhook
No separador Notifications, cada caixa é um canal: notificação na aplicação, pop-up no ecrã, e-mail, som ou webhook. O webhook é o único canal pensado para uma máquina: o TradingView envia a mensagem num pedido HTTP POST para o endereço que indicar. Uma mensagem em JSON válido sai com o cabeçalho application/json; qualquer outro texto, em text/plain. É este o canal que as gateways de execução utilizam.
- Webhook: plano pago do TradingView, Essential ou superior
- Autenticação de dois fatores ativada na sua conta TradingView
- Um endereço https (apenas as portas 80 e 443), que responda em menos de 3 segundos
Enviar o alerta para MT4, MT5 ou cTrader
O TradingView não executa nada na sua corretora: é preciso uma gateway que receba o webhook e transmita a ordem ao terminal. Com o TheConnector, cole o endereço de webhook da sua conta no campo Webhook URL, coloque a mensagem JSON no campo Message e deixe o robô a correr em MT4, MT5 ou cTrader. A mesma mensagem funciona nas três plataformas, e cada alerta é acompanhado desde a receção até à resposta da corretora.
https://webhook.theconnector.fr/A_SUA_CHAVE_DE_ACESSO
{"action":"buy","symbol":"{{ticker}}","risk":1,"sl":20,"tp":40}- Um endereço por conta: mantenha-o secreto, como uma palavra-passe
- A mesma mensagem para MT4, MT5 e cTrader
- Cada alerta acompanhado: Received, Routing, ACK, Delivered
Porque é que um alerta não dispara
A maioria dos alertas «mudos» tem uma causa simples. O alerta expirou, ou estava definido como «uma só vez» e desativou-se após o primeiro disparo. O TradingView também interrompe um alerta disparado mais de 15 vezes em 3 minutos. Num mercado fechado, não chega nenhuma cotação nova, por isso nada dispara. Por fim, um alerta pode ter disparado sem o avisar: o registo de alertas mostra-o, com uma coluna de estado do envio para os webhooks.
- Expirado ou já disparado «uma só vez»: reative-o
- Mais de 15 disparos em 3 minutos: o TradingView interrompe-o, torne a condição mais seletiva
- Indicador que se redesenha: o sinal em tempo real difere do histórico
- Webhook sem efeito: verifique o estado do envio no registo de alertas
Testar antes de negociar em real
Antes de deixar um alerta colocar ordens, verifique cada elo separadamente. Cole primeiro a mensagem no testador de webhook: mostra o que a gateway entende dela, sem executar nada. Depois, dispare um alerta para uma conta demo e acompanhe-o no histórico. Só depois de algumas sessões sem surpresas é que o alerta merece uma conta real, com o volume mínimo.
- A mensagem, no testador de webhook
- Um alerta a sério, para uma conta demo
- A conta real, com o volume mínimo
Guias relacionados
FAQ
Quantos alertas se podem criar no TradingView?
Depende do seu plano TradingView: alguns alertas ativos no plano gratuito, muitos mais nos planos pagos. O número exato consta da página de preços do TradingView, que o vai alterando.
Um alerta do TradingView funciona com o computador desligado?
Sim. Os alertas funcionam nos servidores do TradingView: disparam e enviam os seus webhooks mesmo com o navegador fechado. Só a extensão de navegador Relay, pensada para testar sem plano pago, precisa do separador aberto.
É preciso uma subscrição paga do TradingView para o webhook?
Sim: o campo Webhook URL exige um plano pago, Essential ou superior, e a autenticação de dois fatores ativada. Sem plano pago, pode receber o alerta por e-mail ou testar o TheConnector com a extensão Relay.
Que frequência escolher para negociar automaticamente?
«Uma vez no fecho da vela», num alerta de indicador ou de estratégia: o sinal fica então confirmado. A meio da vela, um cruzamento pode aparecer e depois desaparecer quando a ordem já foi enviada.
As variáveis funcionam num script Pine?
As variáveis entre chavetas duplas são substituídas na mensagem do alerta. No código Pine, o texto constrói-se antes com os valores do script, como syminfo.ticker ou close, e depois passa-se a alert() ou ao parâmetro alert_message de uma estratégia.
Porque é que o meu alerta parou sozinho?
Há três causas frequentes: atingiu a data de expiração, estava definido como «uma só vez», ou disparou mais de 15 vezes em 3 minutos e o TradingView interrompeu-o. O gestor de alertas indica o seu estado.