# 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 <support@goodcrypto.app> 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:

{% embed url="<https://youtu.be/Mx-nD_p2Pgw>" %}

> 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&#x20;
* 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

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fl2pfeXIwqa1tpvsFEldb%2Fimage.png?alt=media&#x26;token=99ca6c17-d547-47c7-abaf-1d1e3bb4e03a" alt="" width="375"><figcaption></figcaption></figure>

Após a criação, você encontrará todas as URLs de webhook disponíveis no **Detalhes** do seu pedido ou bot:

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" alt="" width="375"><figcaption></figcaption></figure>

Resumindo:

| Ação                            | Suportado? | Notas                                                                   |
| ------------------------------- | ---------- | ----------------------------------------------------------------------- |
| 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)                          |

{% hint style="info" %}
**Múltiplos alvos de take-profit com webhooks**

Se você configurar um grupo de take-profit usando webhook como método de gatilho, todos compartilharão a mesma URL de webhook. Cada vez que o webhook for acionado, a próxima ordem de TP na sequência será executada — uma a uma.
{% endhint %}

### 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:

1. Vá para seu gráfico no TradingView
2. Crie um novo alerta com base na sua estratégia, indicador ou condição
3. Nas **configurações do alerta**, ative a caixa de seleção **“Webhook URL”**
4. Cole a URL de webhook específica do goodcryptoX **Webhooks disponíveis** seção
5. Deixe o **campo de mensagem** como está (qualquer conteúdo serve — o goodcryptoX ignora o payload por enquanto)
6. 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:

1. Defina **condição de entrada** = webhook
2. Defina **ordens de média** = 0 (desativar média)
3. Desative ambos **take**-**profit** e **stop-loss**
4. Ative **"Repetir ao fechar posição"**

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNUBBrWgJqqqvjcnLBw7C%2Fimage.png?alt=media&#x26;token=ced6146d-5d8e-4496-94bc-0cb08cb57282" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Ffg4E339WmltyEDaiNjma%2Fimage.png?alt=media&#x26;token=0ee7cab9-7575-4ac2-89c4-841693b2ba77" alt="" width="375"><figcaption></figcaption></figure>

**Configuração no TradingView**

Crie quatro alertas:

1. Preço rompe a banda inferior → enviar para o **Gatilho** URL de webhook
2. Preço retorna para dentro da banda → enviar para **Gatilho de Take Profit** URL de webhook
3. Preço cruza a banda média → enviar para **Gatilho de Take Profit** URL de webhook
4. Preço rompe a banda superior → enviar para **Gatilho de Take Profit** URL de webhook

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fc3oNniHr6lmTUwc8qQ7V%2Fimage.png?alt=media&#x26;token=9787c6e6-5744-48cc-8ae1-a891fd775e8e" alt="" width="375"><figcaption></figcaption></figure>

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:
  1. SMA50 cruza acima da SMA200 → enviar para **Enter Buy** webhook
  2. SMA50 cruza abaixo da SMA200 → enviar para **Enter Sell** webhook
  3. RSI > 70 → enviar para **Fechar posição** webhook

### Resumo

| Conceito              | Descrição                                                            |
| --------------------- | -------------------------------------------------------------------- |
| 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                               |