O que é um webhook do TradingView?

Aviso de risco: Negociar CFDs e outros produtos alavancados é complexo e apresenta alto risco de perder dinheiro rapidamente devido à alavancagem. Dados do setor indicam que 70–80% das contas de negociação de varejo perdem dinheiro com esses produtos. Aviso de risco · Desempenho passado.

Webhooks transformam os alertas do TradingView de notificações passivas em eventos legíveis por máquina. A condição do alerta é o seu gatilho, a mensagem do alerta é o payload e a URL do webhook é o destino. O TradingView nunca recebe nada de volta e nunca envia operações por conta própria — ele apenas dispara o POST. Toda a automação acontece inteiramente no serviço receptor.

Um webhook do TradingView funciona em três partes: um gatilho, um payload e um destino. O gatilho é a condição de alerta que você define — por exemplo, quando uma estratégia dispara uma compra ou venda, ou quando o preço cruza um nível. Quando essa condição é atendida, o TradingView monta a mensagem do alerta e a envia via POST para a URL do webhook.

O payload é tudo aquilo que você escreve no campo Mensagem do alerta. O TradingView permite inserir placeholders que ele substitui por valores ao vivo no momento em que o alerta dispara — assim o serviço receptor recebe o símbolo, o preço e a ação reais, em vez de um texto estático.

• {{ticker}} — o símbolo em que o alerta disparou (ex.: EURUSD)
• {{close}} — o preço de fechamento da barra atual
• {{strategy.order.action}} — "buy" ou "sell" de uma ordem de estratégia
• Uma mensagem típica é JSON, ex.: {"instrument": "{{ticker}}", "direction": "{{strategy.order.action}}", "entry": {{close}}, "sl": <stop-loss>, "tp1": <take-profit>}

A maioria das integrações via webhook espera JSON, porque ele é estruturado e fácil de um serviço receptor analisar. Um padrão comum usa um campo direction para a direção, um campo instrument para o instrumento e campos numéricos para preço, stop-loss e take-profit.

Os placeholders são preenchidos pelo TradingView quando o alerta dispara, então o destino recebe números concretos. Campos como stop-loss, take-profit e tamanho do lote podem ser fixos no código, deixados em zero para significar "nenhum" ou "a mercado", ou alimentados pelas próprias variáveis da sua estratégia — o esquema exato é definido pelo serviço para o qual você envia o webhook, não pelo TradingView.

Um webhook do TradingView permite conectar um alerta a praticamente qualquer coisa capaz de receber um HTTP POST. O uso mais comum em trading é a execução automatizada: o webhook encaminha um sinal de estratégia ou indicador para um serviço que o traduz em uma ordem real numa conta de corretora.

Como o payload é apenas dado, webhooks também são usados para registrar sinais em uma planilha ou banco de dados, enviar notificações para apps de chat ou encadear o TradingView em um pipeline de automação maior. A PipSync, por exemplo, expõe uma URL de webhook por conta que aceita um payload JSON: alertas do TradingView viram sinais que você revisa na página Sinais ou, se você ativar no plano Advanced, são operados automaticamente; webhooks de outros sistemas continuam sempre como sinais que você revisa. O webhook em si, porém, é agnóstico de plataforma e funciona da mesma forma independentemente do receptor.

Somente se você ativar. Por padrão, cada alerta válido se torna um sinal que você revisa na página Sinais, e a PipSync não coloca nenhuma ordem a partir dele. O trading automático é opcional e vem desativado por padrão. Ele exige o plano Advanced: você o configura em Configurações → Avançado → Alertas do TradingView com um consentimento explícito (Configurar trading automático), depois vincula as suas contas e o ativa em Contas e trading automático.

Com o trading automático ativado, a perda no stop loss é limitada ao risco do canal, por padrão 0,5% do saldo da conta. Se o risco não puder ser medido em uma conta (saldo desconhecido, sem dados do contrato ou conta que por enquanto não está em USD — por enquanto o trading automático avalia o risco apenas em pares de moedas: ouro, índices, cripto e outros CFDs em contas MT5, cTrader e Match-Trader não são operados) ou se o lote mínimo da corretora ultrapassar esse limite, essa conta não é operada. Se todas as contas foram recusadas por esses limites, o alerta é mantido como sinal para a sua aprovação; se a corretora rejeitar a ordem em todas as contas, o sinal é marcado como rejeitado. O slippage e os saltos de preço podem fazer a perda real superar o limite. Se o serviço de deduplicação estiver indisponível, os alertas são apenas salvos como sinais. Um alerta só é operado automaticamente quando todas estas condições são atendidas:

• é um alerta JSON — alertas em texto simples são sempre salvos como sinal para a sua aprovação
• vem dos endereços IP de envio publicados pelo TradingView
• não indica um tamanho próprio (por exemplo lots, qty, contracts, size, volume, units, amount ou risk) — se indicar, vira um sinal para a sua aprovação
• o seu plano Advanced continua ativo
• não é uma duplicata — as novas tentativas do TradingView são deduplicadas
• o seu workspace está abaixo de 5 execuções automáticas por minuto
• nenhuma posição no mesmo instrumento aberta por um alerta do TradingView continua aberta, em qualquer direção

A PipSync não fecha posições a partir de alertas do TradingView: as saídas acontecem por stop loss, take profit ou por você. Um alerta na direção oposta enquanto uma posição aberta por um alerta do TradingView continua aberta é retido como provável saída da estratégia e salvo como sinal para a sua aprovação.

Mantenha a URL do webhook em segredo: com o trading automático ativado, qualquer pessoa que a tenha pode acionar operações. Gere uma nova se suspeitar de um vazamento. Um webhook do seu próprio sistema — um bot, um script ou outra ferramenta — nunca é operado automaticamente: ele sempre é salvo como sinal para a sua aprovação. Só os alertas que o próprio TradingView envia, a partir dos endereços de envio publicados por ele, podem operar automaticamente, e só depois que você ativar o recurso.

Um webhook precisa de um destino capaz de aceitar um HTTP POST de entrada em uma URL pública. MetaTrader 4 e MetaTrader 5 são terminais de trading: eles se conectam para fora, a um servidor de corretora, e não expõem um endpoint público de entrada para o qual o TradingView pudesse enviar. Então apontar um alerta do TradingView diretamente para o "MetaTrader" não tem onde aterrissar.

Cobrir essa lacuna exige um intermediário que tenha, sim, uma URL de webhook: ele recebe o POST do TradingView, analisa o JSON e então envia a ordem ao MetaTrader pela API da corretora em seu nome. Esse é exatamente o papel descrito na página metatrader-webhook — o webhook chega a um serviço, e o serviço conversa com o MT4/MT5.