Webhook TradingView para MT4, MT5 e cTrader
O TradingView pode enviar um webhook HTTP quando um alerta dispara, mas não executa sozinho no MetaTrader ou cTrader. O TheConnector recebe o alerta, verifica o payload e roteia a instrução para a conta escolhida com histórico visível.
A mensagem do alerta
{
"action": "buy",
"symbol": "EURUSD",
"volume": 0.10,
"sl": 1.0820,
"tp": 1.0910
}O que faz um webhook TradingView
O webhook é a camada de transporte: envia a mensagem de alerta para uma URL. A execução ainda depende do bridge, terminal, corretora e regras da conta.
- TradingView dispara o alerta
- TheConnector valida o payload
- O terminal recebe apenas sua instrução roteada
Caminho de configuração recomendado
Comece com uma conta e uma mensagem JSON legível. Adicione mapeamento, SL/TP e roteamento multi-conta apenas quando a primeira rota estiver visível no dashboard.
- Criar a rota da conta
- Copiar a URL webhook da conta
- Confirmar histórico antes de aumentar volume
Diferenças entre MT4, MT5 e cTrader
O formato webhook pode ficar estável, mas cada plataforma tem terminal, permissões, símbolos e limites de execução próprios.
- MT4: permissões EA, AutoTrading e sufixos
- MT5: netting ou hedging, filling e passo de volume
- cTrader: cBot ou bridge, permissões Automate e nomes
Quando comparar alternativas
Compare ferramentas por rotas cobertas, clareza das falhas e possibilidade de testar antes de pagar ou mover uma conta real.
- Páginas alternativas ao PineConnector devem ser factuais
- Suporte cTrader é um critério separado
- Comandos tardios devem expirar, não repetir
Trate a URL do webhook como uma palavra-passe
Cada rota de conta tem a sua própria URL de webhook com um token de roteamento: quem tiver a URL pode enviar sinais para essa rota. Nunca a cole num Pine Script público, num fórum ou numa captura de ecrã. Pedidos com token desconhecido são descartados na borda antes de chegarem às suas contas; se suspeitar de uma fuga, pause ou desative a conta no dashboard e contacte o suporte para rodar a rota.
- Uma URL por rota de conta, com o seu token
- Nunca a publicar em scripts, fóruns ou capturas
- Tokens desconhecidos são descartados antes das contas
O que o TradingView exige para enviar um webhook
Três condições do lado do TradingView, sem as quais nada sai. O campo Webhook URL só aparece num plano pago, Essential ou superior, e o TradingView só envia webhooks se a autenticação de dois fatores estiver ativada na conta. Depois, o endereço tem de responder depressa: ao fim de 3 segundos, o TradingView cancela o envio, e só são aceites as portas 80 e 443.
- Plano Essential ou superior, e autenticação de dois fatores ativada
- Um endereço https na porta 443: é o caso do endereço de webhook do TheConnector
- Sem IPv6: o TradingView envia em IPv4, a partir de quatro endereços fixos
JSON ou texto: os dois formatos aceites
Se a mensagem do alerta for um JSON válido, o TradingView envia-a com o cabeçalho application/json; caso contrário, em text/plain. O TheConnector lê os dois. O JSON continua a ser o recomendado: cada campo tem nome e um esquecimento vê-se logo. A forma numa só linha, separada por vírgulas, dá jeito quando a mensagem tem de ser curta.
{"action":"buy","symbol":"EURUSD","risk":1,"sl":0.2,"tp":0.4,"priceMode":"percent"}
buy,EURUSD,risk=1,sl=0.2,tp=0.4,priceMode=percent- JSON: um campo com nome por informação
- Texto: o comando, o símbolo e depois os parâmetros nome=valor
- Uma aspa esquecida e o JSON sai como texto: passe-o pelo testador
Webhook do TradingView que não funciona: a lista de verificação
Siga o alerta pela ordem em que viaja. Primeiro, do lado do TradingView: o registo de alertas diz se o alerta disparou e se o webhook saiu. Depois, do lado do TheConnector: o histórico de alertas mostra se a mensagem chegou e, se não, porque foi recusada. Por fim, do lado do terminal: o robô tem de estar ligado, o trading automático autorizado, e tanto o símbolo como o volume aceites pela sua corretora.
- Nada no histórico: o alerta não saiu, ou o endereço está errado
- Recusado: o motivo fica escrito, muitas vezes o símbolo, a quota ou o formato
- ACK sem execução: trading automático desligado, ou símbolo ou volume recusado pela corretora
Verificar uma mensagem sem risco
O testador de webhook, gratuito e sem conta, passa a sua mensagem pelo mesmo analisador que a gateway de produção e fica por aí: mostra o comando, o símbolo, o volume, o stop e o alvo que nela lê, ou o motivo preciso de uma recusa. Nenhuma ordem é aberta. É a primeira coisa a fazer quando um alerta é recusado pelo seu formato.
- O mesmo analisador que em produção
- Nenhuma conta, nenhuma ordem
- O motivo preciso em caso de recusa
Do primeiro teste à produção
Uma subida segura tem três etapas. Primeiro, uma conta demo e um único alerta manual: veja-o atravessar Received, Routing, ACK e Delivered no dashboard. Depois, deixe a estratégia emitir alertas reais para a rota demo durante algumas sessões e reveja o histórico — rejeições, lacunas de mapeamento, consumo de cota. Só então aponte o alerta para uma conta real, começando com volume mínimo. O plano Basic gratuito (15 webhooks por dia por conta) está dimensionado exatamente para esta fase de validação.
- Etapa 1: um alerta manual para uma rota demo
- Etapa 2: alertas reais da estratégia, ainda em demo
- Etapa 3: conta real com volume mínimo
Guias relacionados
FAQ
Webhooks TradingView executam diretamente no MT4 ou MT5?
Não. TradingView envia a mensagem. Um bridge, robô ou cBot ainda é necessário para rotear a instrução.
Qual plataforma escolher para um webhook TradingView?
Use a plataforma que sua corretora e fluxo já suportam. MT4, MT5 e cTrader têm permissões, símbolos e limites diferentes.
TheConnector é alternativa ao PineConnector?
Pode ser avaliado como fluxo alternativo para webhooks TradingView, especialmente se cTrader, hospedagem UE e validação Basic importam. PineConnector é marca de terceiros.
Um webhook garante execução na corretora?
Não. Um webhook melhora roteamento e rastreabilidade, mas execução depende de terminal, corretora, regras, mercado e risco.
Isto é aconselhamento financeiro?
Não. TheConnector roteia sinais webhook e mostra seus status. Você mantém controle da corretora, contas, estratégia, volumes e risco; não há aconselhamento financeiro nem garantia de execução.
O que acontece se um alerta disparar com o mercado fechado?
O comando é rejeitado e o histórico indica o motivo: vê exatamente o que aconteceu. Nada é repetido em silêncio na próxima abertura a um preço inesperado: a entrega é at-most-once, e um comando fora da janela útil expira por TTL.
Preciso de saber programar?
Não. A mensagem de alerta é um pequeno excerto JSON que copia para a caixa de alertas do TradingView — a documentação e a página de exemplos Pine Script fornecem modelos prontos. Saber Pine Script só importa se a sua estratégia gerar os alertas por programação.
Porque é que o TradingView não envia o meu webhook?
Verifique por esta ordem: um plano pago (Essential ou superior), a autenticação de dois fatores ativada, um endereço https exato e o estado do envio no registo de alertas do TradingView. Se o webhook saiu mas nada chega, o problema está no endereço ou na chave da conta.
O webhook do TradingView aceita texto em vez de JSON?
Sim. O TradingView envia qualquer mensagem, em JSON ou em texto, e o TheConnector lê as duas formas. O JSON continua a ser mais seguro: cada campo tem nome e um erro deteta-se de imediato.