Guia de Bot com Webhook do TradingView

Você montou um alerta no TradingView que dispara exatamente quando você gostaria de entrar em uma operação. O problema: um alerta é apenas uma notificação. Quando você o vê e coloca a ordem, o preço já se moveu — ou você estava dormindo e perdeu a oportunidade por completo.

Um bot com webhook do TradingView fecha essa lacuna. Em vez de notificar você, o alerta notifica uma URL de webhook — um endereço privado na web que pertence ao seu bot. O bot de sinal da Freya fica escutando nesse endereço e, no instante em que seu alerta dispara, ele coloca a operação na sua exchange automaticamente. A lógica do gráfico permanece no TradingView; a Freya cuida da execução.

Este guia cobre os conceitos, a configuração passo a passo e o conhecimento de confiabilidade, segurança e solução de problemas que mantém a conexão funcionando quando mais importa.

Como Funcionam os Alertas e Webhooks do TradingView

Três peças formam o pipeline.

O alerta é uma condição que você define em um gráfico do TradingView: o preço cruzando um nível, um indicador virando, um script personalizado disparando. Sozinho, ele pode aparecer na tela, enviar um e-mail ou uma notificação no celular — e tudo isso ainda exige que você aja.

O webhook é a opção de automação. Quando você o habilita, o TradingView envia uma pequena mensagem pela internet para uma URL da sua escolha no instante em que o alerta é acionado — o alerta faz uma ligação em vez de deixar um recado.

O bot é a ponta receptora. O bot de sinal da Freya expõe uma URL de webhook privada; quando a mensagem chega, o bot executa a ação para a qual foi configurado na sua conta de exchange conectada.

A cadeia completa:

1. Sua condição de gráfico se torna verdadeira no TradingView
2. O alerta dispara e o TradingView chama a URL de webhook do seu bot
3. A Freya recebe o sinal e seu bot coloca a ordem na sua exchange
4. Seu bot então gerencia a posição conforme suas configurações

O modelo mental essencial: sua estratégia vive no TradingView; a Freya é a camada de execução — a lógica de timing está inteiramente dentro do seu alerta.

O Que o Gatilho de Webhook da Freya Faz

Na Freya, a execução via webhook é responsabilidade do bot de sinal — o tipo de bot descrito no fluxo de criação como "Execute operações com base em sinais de webhook". Diferentemente de um gatilho baseado em indicadores (RSI, EMA e afins), o gatilho de webhook não tem timeframe nem condição configurada dentro da Freya — a decisão de quando disparar pertence inteiramente ao seu alerta do TradingView. O trabalho da Freya é o que acontece em seguida.

Existem dois modos de webhook, e cada bot usa um ou outro — eles não podem ser combinados:

• TradingView Webhook (modo Custom Signal). Seu bot recebe duas URLs: uma URL de Webhook de Abertura e uma URL de Webhook de Fechamento. Uma mensagem para a URL de Abertura abre uma posição usando as configurações de ordem definidas na Freya — o valor da operação e seus take-profit e stop-loss; uma mensagem para a URL de Fechamento a fecha.

• Modo Risk Ratio. Seu bot recebe uma URL. A mensagem do alerta é um pequeno payload JSON carregando seus preços de take-profit e stop-loss; a entrada é feita a mercado quando o sinal chega. Em vez de um valor de operação, você define um valor fixo de risco (ancorado no stop-loss ou, opcionalmente, no take-profit), e a Freya dimensiona a posição automaticamente a partir da distância entre a entrada e o stop. Não há URL de Fechamento porque as saídas se resolvem sozinhas: o take-profit é colocado como ordem limite no preço exato do seu sinal, e o stop-loss executa como ordem a mercado quando acionado.

Passo a Passo: Conecte o TradingView ao Seu Bot

Passo 1: Crie um Bot de Sinal

No fluxo Criar Bot da Freya, escolha o tipo Bot de Sinal e depois selecione sua conta de exchange, par de trading e direção — como em qualquer outro bot. O passo a passo completo em Como Criar um Bot de Sinal na Freya Finance cobre cada tela em detalhe.

Passo 2: Escolha Seu Modo de Sinal

Escolha Custom Signal se quiser configurar o valor da operação, o take-profit e o stop-loss dentro da Freya e deixar que seus alertas apenas digam "abra agora" e "feche agora". Escolha Risk Ratio se sua estratégia produz um take-profit e um stop-loss por operação e você quer que o dimensionamento seja calculado automaticamente a partir de um valor fixo de risco.

Passo 3: Copie Sua(s) URL(s) de Webhook

Na etapa de estratégia, a Freya gera sua(s) URL(s) de webhook. Use o botão de copiar — um único caractere faltando torna a URL inútil. Você pode regenerar qualquer URL depois, o que cria uma nova e invalida a antiga imediatamente.

Passo 4: Crie o Alerta no TradingView

No seu gráfico do TradingView, crie um alerta com a condição que representa sua entrada. Nas configurações de notificação do alerta, habilite a opção Webhook URL e cole a URL do seu bot — a URL de Abertura no modo Custom Signal, ou a URL única no modo Risk Ratio. Para saídas acionadas por alerta no modo Custom Signal, crie um segundo alerta para sua condição de saída e aponte-o para a URL de Fechamento.

Passo 5: Defina a Mensagem do Alerta

A mensagem do alerta é o payload que o TradingView entrega ao seu bot. Use exatamente o formato fornecido pela tela de configuração do seu bot — no modo Risk Ratio, a Freya mostra um JSON Body Template com botão de cópia em um clique; seu alerta deve enviar essa estrutura com os valores de take-profit e stop-loss preenchidos. Não improvise: se a mensagem não corresponder ao que o bot espera, o sinal é ignorado, não adivinhado.

Passo 6: Teste Antes de Operar ao Vivo

Nunca conecte um webhook e vá embora. Rode pelo menos uma volta completa com um valor pequeno:

1. Defina uma condição de alerta que você sabe que será acionada rapidamente (o preço cruzando um nível que ele está prestes a tocar)
2. Deixe-a disparar e verifique no log de atividade do seu bot o evento de sinal recebido
3. Confirme que a posição abriu na sua exchange com o tamanho esperado
4. Acione o fechamento (sinal na URL de Fechamento, ou o take-profit/stop-loss no modo Risk Ratio) e confirme que a posição realmente fechou

Só depois de uma volta completa e limpa você deve conectar sua estratégia real e seu tamanho real.

Exemplo Prático: Dimensionamento no Modo Risk Ratio

Suponha que você defina um risco fixo de $20 por operação, ancorado no stop-loss. Seu alerta do TradingView dispara com o BTC a $100.000, carregando na mensagem um stop-loss de $98.000 e um take-profit de $104.000.

• Entrada: a mercado, executada a $100.000
• Distância até o stop-loss: $2.000 por BTC (2%)
• Tamanho da posição: $20 de risco ÷ $2.000 por BTC = 0,01 BTC (cerca de $1.000 de exposição)
• Take-profit: ordem limite a $104.000 — se executar, o lucro é 0,01 × $4.000 = $40, uma recompensa de 2:1 pelos $20 arriscados
• Stop-loss: ordem a mercado se $98.000 for acionado — aproximadamente os $20 que você escolheu, mais taxas, e possivelmente um pouco mais em um movimento rápido, já que um stop acionado executa a mercado

Esteja seu stop a 1% ou a 5% de distância, o valor em dólares em risco continua sendo $20 porque o tamanho se ajusta — essa consistência é exatamente o propósito do modo Risk Ratio.

Confiabilidade: Com o Que Você Pode e Não Pode Contar

A automação é tão confiável quanto seu elo mais fraco — e, com bots de webhook, esse elo geralmente está fora da Freya.

Requisitos de plano do TradingView. As notificações via webhook não estão incluídas em todos os planos do TradingView, e os limites e a expiração de alertas também variam por nível. Um alerta que não pode enviar webhooks falha silenciosamente do ponto de vista do bot — verifique as opções de alerta do seu plano antes de construir sua configuração em torno delas.

Atrasos e quedas acontecem. O marketplace da Freya rotula estratégias baseadas em webhook com um aviso de sinal externo: as operações são acionadas por sinais do TradingView ou de webhook, e atrasos ou quedas na origem são possíveis. Se o TradingView tiver um incidente, seu alerta nunca dispara e o bot — corretamente — não faz nada. A Freya executa o que chega; ela não pode executar o que nunca chega.

Sinais de fechamento perdidos são o risco mais afiado. No modo Custom Signal, se o sinal de abertura chega mas o de fechamento nunca chega, a posição permanece aberta. Um stop-loss configurado nas opções de ordem do seu bot é uma proteção que não depende da chegada de um segundo webhook — vale a pena ter na maioria das configurações.

Alertas de disparo único param de disparar. Um alerta do TradingView configurado como "Apenas uma vez" está encerrado após um sinal até você recriá-lo. Para uma estratégia recorrente, escolha uma opção de disparo repetitivo e verifique a data de expiração do alerta.

Segurança: Sua URL de Webhook É um Segredo

Uma URL de webhook é a chave para acionar seu bot. Não existe senha por cima dela — possuir a URL é a credencial:

• Nunca compartilhe nem publique uma URL de webhook — nem em um print das configurações de alerta, um layout de gráfico compartilhado ou uma mensagem de chat pedindo ajuda. Desfoque ou corte a imagem antes.
• Cole-a apenas em ferramentas que você controla, como seus próprios alertas do TradingView.
• Regenere imediatamente se suspeitar de exposição — a URL antiga para de funcionar na hora. Depois, atualize seus alertas com a nova.

Solução de Problemas: O Alerta Disparou mas Nada Foi Negociado

A causa está quase sempre em uma lista curta — percorra-a na ordem:

1. O bot está rodando? Um bot pausado ou parado ignora os sinais que chegam — o culpado mais frequente.
2. URL certa, lugar certo? Um alerta de entrada apontado para a URL de Fechamento nunca abrirá uma posição. Confirme Abertura vs. Fechamento e confirme que a URL foi colada por completo.
3. Você regenerou recentemente? Regenerar invalida a URL antiga instantaneamente. Se o seu alerta ainda guarda a antiga, as mensagens dele vão para o nada.
4. O formato da mensagem corresponde? Especialmente no modo Risk Ratio, a mensagem precisa corresponder à estrutura JSON da tela de configuração do seu bot. Uma mensagem malformada é ignorada.
5. Seu plano do TradingView consegue enviar webhooks? Se não, o alerta dispara visualmente, mas nenhuma mensagem é enviada. Verifique também se o alerta expirou ou estava configurado como "Apenas uma vez".
6. Mínimos da exchange. Se o valor configurado — ou o tamanho calculado automaticamente no Risk Ratio — ficar abaixo do tamanho mínimo de ordem do par, a exchange rejeita a ordem.

Para problemas de status do bot além de webhooks, veja Por Que Meu Bot Não Está Operando?

Perguntas Frequentes

Preciso de um plano pago do TradingView para usar bots com webhook?

Se o TradingView é sua fonte de sinais, o nível do plano importa: as notificações via webhook não fazem parte de todos os planos, e os alertas do nível gratuito têm limites e regras de expiração mais rígidos. Antes de construir sua automação em torno de alertas, abra o comparativo de planos do TradingView e confirme que as notificações via webhook estão incluídas no seu — e verifique sua cota de alertas se você opera vários pares. Dito isso, o lado do bot não se importa com quem envia a mensagem. O bot de sinal da Freya responde a chamadas de webhook de qualquer origem — outra plataforma de gráficos, um script próprio ou qualquer ferramenta capaz de enviar um webhook. Ou seja, um plano pago do TradingView é uma exigência do recurso de webhook do TradingView, não da Freya. Se o seu plano não inclui webhooks, as alternativas são fazer upgrade, trocar de fonte de sinais ou construir a lógica dentro da Freya com gatilhos baseados em indicadores em vez de sinais externos.

Qual é a diferença entre as URLs de webhook de Abertura e de Fechamento?

No modo Custom Signal, seu bot expõe duas URLs separadas com duas funções distintas. Uma mensagem para a URL de Webhook de Abertura abre uma posição usando as configurações de ordem definidas na Freya — o valor da operação mais qualquer take-profit e stop-loss que você tenha definido. Uma mensagem para a URL de Webhook de Fechamento fecha a posição que o bot mantém aberta. Elas não são intercambiáveis — um alerta de entrada apontado para a URL de Fechamento nunca abrirá uma operação. O modo Risk Ratio funciona de forma diferente — existe apenas uma URL, usada para o sinal de entrada, e não há URL de Fechamento porque a saída é tratada automaticamente pelo take-profit e stop-loss carregados na mensagem do webhook. Ambas as URLs podem ser copiadas e regeneradas de forma independente; regenerar cria uma URL nova e invalida a antiga imediatamente, então atualize o alerta correspondente no TradingView logo em seguida.

Meu alerta do TradingView pode definir o take-profit e o stop-loss?

Sim — é exatamente para isso que serve o modo Risk Ratio. Nesse modo, a mensagem do seu alerta é um pequeno payload JSON que carrega os preços de take-profit e stop-loss, e a tela de configuração da Freya fornece o JSON Body Template para copiar no seu alerta. Quando o sinal chega, a entrada é feita ao preço de mercado e as saídas são colocadas a partir dos valores do seu sinal: o take-profit como ordem limite no preço exato que você enviou, e o stop-loss como ordem a mercado quando seu preço de gatilho é atingido. Como o stop executa a mercado, ele pode sofrer slippage em um movimento rápido — como qualquer ordem de stop. No modo Custom Signal, o webhook não pode definir níveis de saída; o take-profit e o stop-loss vêm das configurações de ordem definidas dentro da Freya, e seus alertas se limitam a dizer quando abrir e quando fechar.

É seguro colar minha URL de webhook no TradingView?

Colar a URL no seu próprio alerta do TradingView é o uso previsto — é a integração funcionando como projetada. O risco real é a exposição, não a colagem em si. Uma URL de webhook não tem senha por cima: quem tiver a URL pode acionar aquela ação no seu bot. Os caminhos de vazamento mais comuns são banais: um print das configurações de alerta compartilhado em um chat, uma postagem pública pedindo ajuda ou um layout de gráfico compartilhado. Trate cada URL como uma senha: mantenha-a fora de capturas de tela, não a compartilhe com ninguém e cole-a apenas em ferramentas que você pessoalmente controla. Se alguma vez suspeitar que uma URL foi vista por outra pessoa, regenere-a imediatamente — a antiga para de funcionar no momento em que a nova é criada — e então atualize seu alerta com a substituta antes que o próximo sinal dispare.

Por que meu alerta disparou mas nenhuma operação aconteceu?

Comece pelo próprio bot: um bot pausado ou parado ignora sinais por completo — a causa mais comum. Em seguida, verifique o encanamento: o alerta precisa guardar a URL correta e completa (Abertura, não Fechamento, para entradas) — e, se você regenerou recentemente, o alerta pode ainda apontar para a URL morta. Depois, cheque a mensagem: principalmente no modo Risk Ratio, o payload precisa corresponder ao template JSON da tela de configuração do seu bot, ou o sinal é ignorado. No lado do TradingView, confirme que seu plano realmente envia webhooks e que o alerta não expirou nem gastou seu único disparo em "Apenas uma vez". Por fim, se o seu valor — ou o tamanho calculado automaticamente no Risk Ratio — estiver abaixo do mínimo da exchange para o par, a ordem é rejeitada. O log de atividade do seu bot revela qual lado falhou: um sinal registrado indica problema de execução; nenhum registro significa que o sinal nunca chegou.

Meus sinais precisam vir do TradingView?

Não. O TradingView é a fonte mais popular porque seu sistema de alertas é flexível e orientado a gráficos, mas o bot de sinal da Freya responde a chamadas de webhook independentemente da origem. Qualquer ferramenta capaz de enviar um webhook funciona: outra plataforma de gráficos, um script próprio, um screener com notificações via webhook ou um sistema de sinais interno. O contrato é o mesmo em todos os casos — chamar a URL de Abertura ou de Fechamento no modo Custom Signal, ou enviar o payload JSON esperado com os valores de take-profit e stop-loss para a URL única no modo Risk Ratio. Duas ressalvas valem para qualquer fonte. Primeiro, a questão da confiabilidade não desaparece: seu bot só pode executar sinais que realmente chegam, então o uptime da sua fonte é o uptime da sua estratégia. Segundo, a regra de segurança é universal — seja qual for a ferramenta, a URL de webhook só entra em sistemas que você controla e nos quais confia.

Próximos Passos

Um bot de webhook é tão bom quanto a estratégia que o alimenta. Teste sua lógica de sinais contra o histórico com Como Fazer Backtesting da Sua Estratégia de Trading de Criptomoedas e leia o passo a passo completo em Como Criar um Bot de Sinal na Freya Finance se pulou algum detalhe da configuração. Se preferir construir a lógica de entrada dentro da Freya, o Guia de Estratégia de Bot DCA cobre essa abordagem em profundidade. E, para dúvidas sobre custódia e permissões de chaves de API, veja Meu Dinheiro Está Seguro na Freya Finance?