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 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 ordens e lógica multi-símbolo — atuando efetivamente como uma camada de API. Fique atento
Segurança e acesso
Por enquanto, webhooks são aceitos apenas 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.
Webhooks estão disponíveis apenas para usuários com um PRO ativo plano ou superior.
Como os webhooks funcionam no goodcryptoX
Toda 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
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)
Acionamentos 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 nos 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 configurado na criaçã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 do 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 baseado 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 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 executa e o TP ou SL vinculado dispara, toda a negociação está completa. 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 introduziremos um bot de estratégia do TradingView dedicado 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 dirigida por webhooks.
Loop puro de webhook
Para configurar um bot que entre em uma posição por um webhook, saia por um webhook e então repita:
Defina condição de entrada = webhook
Defina ordens de averaging = 0 (desativar averaging)
Desative ambas take-profit e stop-loss
Ative "Repetir ao fechar posição"
Uma vez que o bot seja lançado, você verá as seguintes URLs de webhook em Detalhes → Webhooks do bot:
Entrar Compra — abre uma posição Long
Entrar Venda — 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 Compra, ele abre uma posição longa.
Quando recebe Entrar Venda, ele abre uma posição curta.
O bot irá responder apenas ao primeiro webhook de entrada que receber enquanto estiver ocioso.
Enquanto uma posição estiver aberta:
Quaisquer sinais adicionais de entrada são ignorados
O bot não aumentará nem reverterá a posição atual em sinais de Entrada
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 se reinicia e aguarda o próximo webhook de Entrada.
Esse loop continua enquanto o bot permanecer ativo, permitindo que você repita um ciclo completo de entrada → saída → reinício indefinidamente.
Modo puro de 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 embutidos baseados em preço
Averaging: opcional; pode ser desativado
Você pode:
Executar um bot inteiramente via sinais de webhook (entrada e saída)
Adicionar TP/SL baseados em preço como backups, mesmo que você use saídas por webhook
Adicionar ordens de averaging para proteção adicional
Isso torna possível projetar:
Estratégias de loop totalmente automatizadas (webhook puro)
Bots acionados por sinais com failovers manuais
Configurações híbridas com saídas em múltiplas camadas
Exemplos práticos de estratégia com webhooks
Exemplo 1: Ordem única + múltiplos take profits (rebote 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 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 da seção Webhooks do goodcryptoX. Deixe o campo Mensagem como está — ele não é usado.
Exemplo 2: Estratégia repetitiva com bot DCA (Golden/Death Cross)
Objetivo: Entrar em posição longa no Golden Cross, entrar em posição curta 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
Averaging = desligado (defina como 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 Entrar Compra webhook
SMA50 cruza abaixo da SMA200 → enviar para Entrar Venda 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 do webhook → colar no alerta do TradingView
Estratégia repetitiva
Use o bot DCA com repetição habilitada
Acesso
Requer plano PRO ou superior
Tutoriais em vídeo
Introdução ao trading com webhook
Usando o bot DCA com webhooks
Múltiplos take-profits com webhooks
Last updated