> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-pt/dex-trading-spot/webhooks.md).

# Webhooks

goodcryptoX permite automatizar o trading em DEX via webhooks do TradingView — um mecanismo poderoso para acionar ordens e ações do bot diretamente a partir dos seus sinais.

Ao contrário de algumas implementações que tratam os webhooks como uma API programável (em que envia comandos parametrizados como "comprar 3 BTC"), o goodcryptoX suporta atualmente um modelo baseado em triggers. Cada webhook simplesmente ativa uma ação predefinida numa ordem ou bot específico — não são interpretados parâmetros nem comandos.

Num futuro próximo, lançaremos um novo bot de Estratégia do TradingView que suporta instruções completas de estratégia via webhooks, incluindo seleção dinâmica de símbolo, quantidades, tipos de ordem e lógica multissímbolo — funcionando efetivamente como uma camada de API. Fique atento

> Os webhooks só são aceites de servidores TradingView por agora — sem IPs personalizados ou fontes externas.\
> Se precisar de usar uma origem de webhook personalizada, contacte-nos em <support@goodcrypto.app> para pedir acesso.

### Como os webhooks funcionam no goodcryptoX

* Cada ordem ou bot **ação** tem a sua própria URL de webhook dedicada
* Tem de criar primeiro a ordem ou o bot para obter a URL (elas aparecerão na secção **Webhooks** da ordem ou da secção **Detalhes**)
* Enviar **qualquer** payload de webhook para essa URL irá acionar a ação

Aqui está uma visão geral em vídeo:

> Os URLs de webhook são específicos da ação. Tem de criar um webhook por ação, por ex., um para entrada, um para take profit, um para stop loss, etc., para cada bot ou ordem

### Ações de ordem e bot suportadas

Se quiser que a sua ordem ou bot seja **acionada por um webhook**, tem de selecionar webhook como **condição de trigger durante a configuração**. Isto aplica-se a:

* Acionamento de ordens limite
* Ativação da ordem trailing (início do trailing)
* Triggers 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

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Após a criação, encontrará todas as URLs de webhook disponíveis na secção **Detalhes** da sua ordem ou bot:

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Em resumo:

| Ação                            | Suportado? | Notas                                                                     |
| ------------------------------- | ---------- | ------------------------------------------------------------------------- |
| Cancelar ordem                  | ✅          | Sempre mostrado nos detalhes                                              |
| Acionar ordem limite            | ✅          | Tem de 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 (tem de 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 configurar um grupo de take profit usando webhook como método de trigger, todos irão partilhar a mesma URL de webhook. Sempre 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 a sua ordem ou bot no goodcryptoX e copiar a URL do webhook para uma ação específica, veja aqui como ligá-la aos seus alertas do TradingView:

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

### Estratégias repetitivas (via bot DCA)

Uma ordem acionada por webhook (por ex., limite com TP e SL) é uma **configuração única**. Assim que a ordem for executada e o TP ou SL associado for acionado, a operação fica concluída. Se quiser que esta estrutura **se repita automaticamente**, isso não é possível com ordens — mas já é possível usando o bot DCA.

Em breve, introduziremos um bot dedicado de estratégia do TradingView para suportar trades multi-ação repetitivos, mas, entretanto, o bot DCA fornece uma forma flexível de repetir a sua estratégia orientada por webhook.

#### Ciclo puro de webhook

Para configurar um bot que entra numa posição por webhook, sai por webhook e depois 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 a posição"**

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Depois de o bot ser iniciado, verá as seguintes URLs de webhook por baixo da secção **Detalhes → Webhooks** do bot:

* **Entrada Compra** — 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 **Entrada Compra**, abre uma posição long.
* O bot irá **responder apenas ao primeiro webhook de entrada** que receber enquanto estiver inativo.
* Enquanto houver uma posição aberta:
  * Quaisquer sinais de entrada adicionais são **ignorados**
  * Os únicos sinais aceites são **fechar posição** ou um TP/SL acionado (se configurado)
* Assim que a posição é fechada (manualmente, por webhook, ou por SL/TP), o bot reinicia e aguarda o próximo webhook de Entrada.

Este ciclo continua enquanto o bot permanecer ativo, permitindo repetir indefinidamente um ciclo completo de entrada → saída → reinício.

#### Modo puramente por webhook vs configurações híbridas

O bot DCA suporta várias camadas de controlo que podem ser combinadas para criar estratégias flexíveis:

* **Entrada**: via webhook, sinal ou instantâneo
* **Saída**: via webhook, ou TP/SL nativos baseados no preço
* **Média**: opcional; pode ser desativada

Pode:

* Executar um bot totalmente através de sinais de webhook (entrada e saída)
* Adicionar TP/SL baseados no preço como alternativas, mesmo que use saídas por webhook
* Adicionar ordens de média para proteção adicional

Isto torna possível conceber:

* Estratégias de ciclo totalmente automatizadas (webhook puro)
* Bots orientados por sinais com fallbacks manuais
* Configurações híbridas com saídas em múltiplas camadas

### Exemplos práticos de estratégias com webhook

#### Exemplo 1: Ordem única + múltiplos take profits (rebote na Banda 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 limite com condição de acionamento = webhook
* Adicione três alvos de take profit. Trigger de TP = webhook

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**Configuração no TradingView**

Crie quatro alertas:

1. O preço rompe a banda inferior → enviar para o **Trigger** URL do webhook
2. O preço regressa para dentro da banda → enviar para **Trigger de Take Profit** URL do webhook
3. O preço cruza a banda média → enviar para **Trigger de Take Profit** URL do webhook
4. O preço rompe a banda superior → enviar para **Trigger de Take Profit** URL do webhook

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Nas **definições do alerta**, ative a caixa de seleção **“Webhook URL”**

Cole a URL de webhook específica da goodcryptoX **Webhooks disponíveis** secção. Deixe o campo Message como está — não é usado.

#### Exemplo 2: Estratégia repetitiva com bot DCA (Cruz Dourada/Cruz da Morte)

**Objetivo:** Entrar long na Cruz Dourada, entrar short na Cruz da Morte. Sair com um lucro de 10% ou quando RSI > 70 e repetir para sempre.

**Configuração no goodcryptoX**

Criar bot DCA

* Condição de entrada = webhook
* Média = desativada (definir para 0)
* Take Profit = 10%
* Stop loss = desativado
* Ativar: "Repetir no TP"

**Configuração no TradingView**

* Crie três alertas no mesmo gráfico:
  1. SMA50 cruza acima da SMA200 → enviar para **Entrada Compra** webhook
  2. SMA50 cruza abaixo da SMA200 → enviar para **Entrada Venda** webhook
  3. RSI > 70 → enviar para **Fechar posição** webhook

### Resumo

| Conceito              | Descrição                                                            |
| --------------------- | -------------------------------------------------------------------- |
| Modelo de trigger     | Cada ação tem a 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 ativada                                  |
