Tema
Idioma
webhookpine scripttradingviewtrading botfreeautomation

Como conectar Pine Script a um bot comercial via Webhooks

Como conectar Pine Script a um bot comercial via Webhooks
Por fomoed Team12 de abril de 20266 min de leitura

O que este guia cobre

Se você tem uma estratégia Pine Script em TradingView que gera bons sinais, você pode automatizá-la. Em vez de observar alertas e fazer negociações manualmente, um bot webhook recebe seus sinais Pine Script e os executa instantaneamente em sua exchange.

O fluxo: Pine Script dispara alerta → TradingView envia webhook → fomoed recebe-o → bot realiza negociações em sua exchange. Totalmente automatizado, sem necessidade de intervenção manual.

Como funcionam os alertas Pine Script

Os alertas TradingView podem ser acionados em qualquer condição no seu código Pine Script. Quando você usa alertcondition() ou a função alert() mais recente, TradingView avalia suas condições em seus servidores e dispara o alerta sempre que a condição se torna verdadeira.

O principal recurso: TradingView pode enviar um webhook (uma solicitação HTTP POST para um URL) sempre que um alerta é acionado. Este webhook carrega uma carga útil — uma mensagem que você define — que contém as informações comerciais.

Etapa 1: Prepare seu Pine Script

Seu Pine Script precisa gerar sinais claros e analisáveis. A abordagem mais simples usa a função alert() com uma carga útil JSON:

//@version=5
estratégia("Minha Estratégia", overlay=true)

//Sua lógica de entrada/saída
longCondition = ta.crossover(ta.sma(fechar, 20), ta.sma(fechar, 50))
condição curta = ta.crossunder(ta.sma(fechar, 20), ta.sma(fechar, 50))

if (condição longa)
    estratégia.entry("Longo", estratégia.long)
    alert('{"action": "comprar", "symbol": "' + syminfo.ticker + '", "preço": ' + str.tostring(close) + '}', alert.freq_once_per_bar_close)

if (condição curta)
    estratégia.close("Longo")
    alert('{"action": "vender", "symbol": "' + syminfo.ticker + '", "preço": ' + str.tostring(close) + '}', alert.freq_once_per_bar_close)

Pontos principais:

  • Use alert.freq_once_per_bar_close para evitar vários sinais por barra
  • Inclua a ação (compra/venda), o símbolo e o preço atual em sua carga
  • Use o formato JSON válido para que o bot receptor possa analisá-lo de forma limpa

Etapa 2: crie um Bot Webhook em fomoed

No painel fomoed, crie um novo bot e selecione a estratégia Webhook. Isso gera um URL de webhook exclusivo para o seu bot — algo como:

https://api.fomoed.com/webhook/bot/abc123xyz

Este URL são os "ouvidos" do seu bot — qualquer solicitação POST formatada corretamente enviada a ele aciona a execução da negociação. Mantenha-o privado - qualquer pessoa com o URL pode enviar sinais para o seu bot.

Configuração do bot do Webhook

Defina estas configurações na configuração do bot do webhook:

ConfiguraçãoFinalidadeExemplo
TrocaOnde as negociações são executadasHyperliquid, Binance, Bybit
ParO que negociar (ou dinâmico da carga útil)BTC/USDC
Tamanho da posiçãoQuanto por sinalUS$ 500 ou 2% de saldo
AlavancagemAlavancagem para negociações perp3x
Take ProfitAuto TP nas entradas2%
Stop lossAuto SL on entradas1%

Etapa 3: Conecte TradingView ao URL do seu webhook

  1. Em TradingView, adicione sua estratégia Pine Script a um gráfico
  2. Clique com o botão direito na estratégia → "Adicionar alerta"
  3. Na caixa de diálogo de alerta, defina a condição para sua estratégia
  4. Em "Notificações", ative o URL do webhook
  5. Cole o URL do webhook fomoed
  6. No campo "Mensagem", defina o formato da carga
  7. Defina a expiração como "Aberta" para operação contínua
  8. Clique em "Criar"

A mensagem de alerta (carga útil)

O campo da mensagem é o que é enviado ao seu URL do webhook. Use este formato para compatibilidade com fomoed:

{ "ação": "{{strategy.order.action}}", "símbolo": "{{ticker}}", "preço": {{fechar}}, "quantidade": "{{strategy.order.contracts}}" }

TradingView substitui {{placeholders}} por valores reais quando o alerta é acionado. O resultado é um objeto JSON limpo que seu bot webhook pode analisar e executar.

Etapa 4: testar a conexão

Antes de confiar em seu bot webhook para negociações reais:

  1. Defina o bot para o modo paper trading
  2. Dispare um alerta de teste de TradingView (use o botão "Testar" no alerta configurações)
  3. Verifique seu painel fomoed — você deverá ver o sinal recebido
  4. Verifique se a negociação em papel foi colocada corretamente (par certo, direção certa, tamanho certo)

Se o teste falhar, os problemas comuns incluem:

  • JSON malformado na mensagem de alerta (verifique colchetes e aspas)
  • URL de webhook incorreto (copiar e colar) erro)
  • O plano TradingView não suporta webhooks (requer plano pago)

Etapa 5: Entre no ar

Depois que os testes em papel confirmarem que a conexão funciona:

  1. Mude seu bot de webhook do modo papel para o modo ativo
  2. Mantenha seu alerta TradingView ativo (ele já está apontando para o URL correto)
  3. O próximo sinal da sua estratégia Pine Script executará uma negociação real

Referência de formato de carga útil

Os bots webhook fomoed aceitam estes campos:

CampoValoresobrigatórios
açãoSim"comprar", "vender", "fechar"
símboloNão (usa bot padrão)"BTCUSDC", "ETHUSDC"
preçoNãoPreço de execução (mercado se omitido)
quantidadeNão (usa o padrão do bot)Tamanho da posição
takeProfitNão (usa o padrão do bot)Preço ou porcentagem do TP
stopLossNão (usa o bot padrão)Preço ou porcentagem de SL

Avançado: múltiplas estratégias, um bot

Você pode apontar vários alertas Pine Script para o mesmo bot de webhook — útil se você tiver sinais em prazos diferentes ou condições diferentes que negociam o mesmo par. O bot processa cada sinal de forma independente.

Como alternativa, crie bots webhook separados para estratégias distintas, cada um com seus próprios parâmetros de risco. Isso proporciona rastreamento independente de PnL e gerenciamento de riscos por estratégia.

Avançado: condições de alerta personalizadas

Além dos sinais básicos de compra/venda, você pode enviar cargas úteis mais diferenciadas:

  • Fechamentos parciais: {"action": "sell", "quantity": "50%"}
  • Ativação de rastreamento: {"action": "buy", "trailingStop": "2%"}
  • Vários TPs: Defina na configuração do bot; o webhook apenas aciona a entrada

TradingView Requisitos do plano

Uma observação importante: os webhooks TradingView exigem um plano TradingView pago (Pro, Pro+ ou Premium). O plano TradingView gratuito não oferece suporte a notificações de webhook — apenas alertas na tela e por e-mail.

No entanto, uma vez que você tenha um plano TradingView, o próprio bot de webhook fomoed é totalmente gratuito. Nenhuma assinatura adicional necessária no lado da execução.

Solução de problemas comuns

  • "Webhook falhou" em TradingView — verifique se o URL está correto e o bot fomoed está ativo
  • Sinal recebido, mas sem negociação — verifique se o formato da carga útil corresponde aos campos esperados; verifique se o bot está no modo ao vivo
  • Negociações duplicadas — use alert.freq_once_per_bar_close para evitar vários sinais por barra
  • Execução atrasada — normal para atraso de 1 a 3 segundos; garanta que sua estratégia leve em conta isso em prazos rápidos

Próximas etapas

Para configurações de bot de webhook mais detalhadas, leia nosso TradingView guia de negociação automática de webhook. Para uma visão geral mais ampla das estratégias de webhook e manipulação avançada de carga útil, consulte nosso guia completo de bots webhook.

A combinação do poder analítico do Pine Script e da infraestrutura de execução do fomoed significa que você pode criar estratégias sofisticadas no TradingView e executá-las automaticamente, por gratuito.

Pronto para automatizar sua estratégia Pine Script? Crie sua conta fomoed gratuita, configure um bot webhook e conecte seus alertas TradingView em minutos.