Webhooks
goodcryptoX permite automatizar ações de negociação via webhooks do TradingView — um mecanismo poderoso para acionar ordens e ações de bots diretamente a partir dos seus sinais.
Ao contrário de algumas implementações que tratam webhooks como uma API programável (onde você envia comandos parametrizados como "comprar 3 BTC"), o goodcryptoX atualmente suporta um modelo baseado em gatilho. Cada webhook simplesmente ativa uma ação predefinida em uma ordem ou bot específico — nenhum parâmetro ou comando é interpretado.
Em um futuro próximo, lançaremos um novo bot de estratégia do TradingView que suportará instruções completas de estratégia via webhooks, incluindo seleção dinâmica de símbolo, quantidades, tipos de ordem e lógica multi-símbolo — atuando efetivamente como uma camada de API. Fique atento
Por enquanto, webhooks só são aceitos dos servidores do TradingView — sem IPs personalizados ou fontes externas. Se você precisar usar uma fonte de webhook personalizada, entre em contato conosco em [email protected] para solicitar acesso.
Como os webhooks funcionam no goodcryptoX
Cada ordem ou bot ação possui sua própria URL de webhook dedicada
Você deve criar a ordem ou o bot primeiro para obter a URL (elas aparecerão na Webhooks seção dos Detalhes)
Enviar qualquer payload de webhook para essa URL acionará a ação
As URLs de webhook são específicas da ação, não do usuário. Você deve criar um webhook por ação, por exemplo um para entrada, um para take profit, um para stop loss etc. para cada bot ou ordem
Ações de ordens e bots suportadas
Se você quiser que sua ordem ou bot seja acionado por um webhook, você deve selecionar webhook como a condição de gatilho durante a configuração. Isso se aplica a:
Ordens stop-market / stop-limit acionam
Ativação de ordens trailing (início do trailing)
Gatilhos de take-profit e stop-loss
Condição de entrada de bots DCA
Após a criação, você encontrará todas as URLs de webhook disponíveis no Detalhes do seu pedido ou bot:
Cancelar webhook — sempre disponível em todas as ordens e bots
Fechar posição webhook — sempre disponível nos detalhes do bot DCA
Para resumir:
Cancelar ordem
✅
Sempre mostrado nos detalhes
Acionar ordem Stop
✅
Deve selecionar webhook na configuração
Ativar ordem Trailing
✅
Início do trailing = webhook
Acionar take profit / stop loss
✅
Opcionalmente acionado por webhook
Bot DCA - entrada
✅
Compra/venda de entrada via webhook (deve ser definido na configuração)
Bot DCA - saída
✅
Fechar posição via webhook (sempre disponível)
Bot Grid - entrada
🚫
Ainda não suportado
Como configurar alertas no TradingView
Depois de criar sua ordem ou bot no goodcryptoX e copiar a URL de webhook para uma ação específica, veja como vinculá-la aos seus alertas do TradingView:
Vá para seu gráfico no TradingView
Crie um novo alerta com base na sua estratégia, indicador ou condição
Nas configurações do alerta, habilite a caixa de seleção “Webhook URL”
Cole a URL de webhook específica da seção Webhooks do goodcryptoX
Deixe o campo de mensagem como está (qualquer conteúdo serve — o goodcryptoX ignora o payload por enquanto)
Salve o alerta
Estratégias repetitivas (via bot DCA)
Uma ordem acionada por webhook (por exemplo stop-market com TP e SL) é uma configuração única. Uma vez que a ordem é executada e o TP ou SL vinculado dispara, toda a negociação é concluída. Se você quiser que essa estrutura se repita automaticamente, isso não é possível com ordens — mas é alcançável agora usando o bot DCA.
Em breve apresentaremos um dedicado bot de estratégia do TradingView para suportar negociações repetidas com múltiplas ações, mas enquanto isso, o bot DCA fornece uma forma flexível de repetir sua estratégia acionada por webhook.
Loop puramente via webhook
Para configurar um bot que entra numa posição por webhook, sai por webhook e então repete:
Defina condição de entrada = webhook
Defina ordens de média = 0 (desativar média)
Desative ambas tomar-lucro e stop-loss
Habilite “Repetir ao fechar posição”
Uma vez que o bot é lançado, você verá as seguintes URLs de webhook em Detalhes → Webhooks do bot:
Entrar Buy — abre uma posição Long
Entrar Sell — abre uma posição Short
Fechar posição — fecha a posição ativa (long ou short)
Cancelar — para o bot
Lógica de execução
Quando o bot recebe Entrar Buy, ele abre uma posição long.
Quando recebe Entrar Sell, ele abre uma posição short.
O bot irá responder apenas ao primeiro webhook de entrada que receber enquanto estiver ocioso.
Enquanto uma posição estiver aberta:
Qualquer sinal adicional de entrada será ignorado
O bot não aumentará nem reverterá a posição atual com sinais de Entry
Os únicos sinais aceitos são fechar posição ou um TP/SL acionado (se configurado)
Uma vez que a posição é fechada (manualmente, por webhook ou por SL/TP), o bot se reinicia e aguarda o próximo webhook de Entry.
Esse loop continua enquanto o bot permanecer ativo, permitindo que você repita um ciclo completo de entrada → saída → reinício indefinidamente.
Modo puramente webhook vs configurações híbridas
O bot DCA suporta múltiplas camadas de controle que podem ser combinadas para construir estratégias flexíveis:
Entrada: via webhook, sinal ou asap
Saída: via webhook, ou TP/SL integrados baseados em preço
Média: opcional; pode ser desativada
Você pode:
Executar um bot inteiramente via sinais de webhook (entrada e saída)
Adicionar TP/SL baseados em preço como soluções de fallback, mesmo se você usar saídas por webhook
Adicionar ordens de média para proteção adicional
Isso torna possível projetar:
Estratégias de loop totalmente automatizadas (puro webhook)
Bots dirigidos por sinal com failovers manuais
Configurações híbridas com saídas em múltiplas camadas
Exemplos práticos de estratégias com webhooks
Exemplo 1: Ordem única + múltiplos take profits (ressalto na Bandas de Bollinger)
Objetivo: Comprar quando o preço romper a banda inferior de Bollinger, vender progressivamente conforme sobe.
Configuração no goodcryptoX
Crie uma ordem stop-market com condição de gatilho = webhook
Adicione três alvos de take-profit. Gatilho de TP = webhook
Configuração no TradingView
Crie quatro alertas:
Preço rompe a banda inferior → enviar para Gatilho URL de webhook
Preço volta para dentro da banda → enviar para Gatilho de Take Profit URL de webhook
Preço cruza a banda média → enviar para Gatilho de Take Profit URL de webhook
Preço rompe a banda superior → enviar para Gatilho de Take Profit URL de webhook
Nas configurações do alerta, habilite a caixa de seleção “Webhook URL”
Cole a URL de webhook específica da seção Webhooks do goodcryptoX. Deixe o campo Mensagem como está — não é utilizado.
Exemplo 2: Estratégia repetitiva com bot DCA (Golden/Death Cross)
Objetivo: Entrar Long no Golden Cross, entrar Short no Death Cross. Sair com 10% de lucro ou quando o RSI > 70 e repetir para sempre.
Configuração no goodcryptoX
Crie o bot DCA
Condição de entrada = webhook
Média = desligada (defina para 0)
Take Profit = 10%
Stop loss = desligado
Habilite: "Repetir no TP"
Configuração no TradingView
Crie três alertas no mesmo gráfico:
SMA50 cruza acima da SMA200 → enviar para Entrar Buy webhook
SMA50 cruza abaixo da SMA200 → enviar para Entrar Sell webhook
RSI > 70 → enviar para Fechar posição webhook
Resumo
Modelo de gatilho
Cada ação tem sua própria URL de webhook
Fluxo de configuração
Criar ordem → copiar URL de webhook → colar no alerta do TradingView
Estratégia repetitiva
Use o bot DCA com repetição habilitada
Tutoriais em vídeo
Introdução ao trading com webhooks
Usando o bot DCA com webhooks
Múltiplos take-profits com webhooks
Last updated