🔗Webhooks
goodcryptoX permite automatizar negociações em DEX 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 gatilhos. 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, os webhooks são aceitos apenas dos servidores do TradingView — sem IPs personalizados ou fontes externas. Se você precisa 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 tem 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
Aqui está uma visão geral em vídeo:
As URLs de webhook são específicas para cada ação. 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ê quer 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 limit trigger
Ativação de ordem trailing (início do trailing)
Gatilhos de take-profit e stop-loss
Condição de entrada do bot DCA
Cancelar webhook — sempre disponível em todas as ordens e bots
Fechar posição webhook — sempre disponível nos detalhes do bot DCA
Após a criação, você encontrará todas as URLs de webhook disponíveis no Detalhes do seu pedido ou bot:
Resumindo:
Cancelar ordem
✅
Sempre exibido nos detalhes
Trigger de ordem Limit
✅
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)
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, ative a caixa de seleção “Webhook URL”
Cole a URL de webhook específica do goodcryptoX Webhooks disponíveis seção
Deixe o campo de mensagem como está (qualquer conteúdo serve — o goodcryptoX ignora o payload por enquanto)
Salve o alerta
Estratégias repetidas (via bot DCA)
Uma ordem acionada por webhook (por exemplo, limit com TP e SL) é uma configuração única. Uma vez que a ordem seja executada e o TP ou SL vinculado dispare, toda a negociação está completa. Se você quer 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 bot de estratégia dedicado do TradingView para suportar negociações repetidas com múltiplas ações, mas, enquanto isso, o bot DCA oferece uma maneira flexível de repetir sua estratégia acionada por webhook.
Loop puramente por webhook
Para configurar um bot que entra em uma 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 ambos take-profit e stop-loss
Ative "Repetir ao fechar posição"
Uma vez que o bot esteja em operação, você verá as seguintes URLs de webhook em Detalhes → Webhooks do bot:
Enter Buy — abre uma posição Long
Fechar posição — fecha a posição ativa (long ou short)
Cancelar — para o bot
Lógica de execução
Quando o bot recebe Enter Buy, ele abre uma posição long.
O bot responderá apenas ao primeiro webhook de entrada que receber enquanto estiver ocioso.
Enquanto uma posição estiver aberta:
Qualquer sinal de entrada adicional é ignorado
Os únicos sinais aceitos são fechar posição ou um TP/SL acionado (se configurado)
Uma vez que a posição seja fechada (manualmente, por webhook ou por SL/TP), o bot é reiniciado e espera pelo próximo webhook de Entrada.
Este 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 instantâneo
Saída: via webhook, ou TP/SL integrado baseado 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 baseado em preço como 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 acionados por sinais 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 pontual + múltiplos take profits (ressalto na Bandas de Bollinger)
Objetivo: Comprar quando o preço romper a banda inferior de Bollinger, vender progressivamente à medida que sobe.
Configuração no goodcryptoX
Crie uma ordem limit 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 o Gatilho URL de webhook
Preço retorna 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, ative a caixa de seleção “Webhook URL”
Cole a URL de webhook específica do goodcryptoX Webhooks disponíveis seção. Deixe o campo Mensagem como está — ele não é usado.
Exemplo 2: Estratégia repetida com bot DCA (Golden/Death Cross)
Objetivo: Entrar em long no Golden Cross, entrar em 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 = desligado (definir para 0)
Take Profit = 10%
Stop loss = desligado
Ative: "Repetir no TP"
Configuração no TradingView
Crie três alertas no mesmo gráfico:
SMA50 cruza acima da SMA200 → enviar para Enter Buy webhook
SMA50 cruza abaixo da SMA200 → enviar para Enter 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
Last updated