> 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/perp-dexs/webhooks.md).

# Webhooks

O goodcryptoX permite automatizar ações de trading 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](https://docs.goodcrypto.app/goodcryptox-pt/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) que suporta instruções completas de estratégia via webhooks, incluindo seleção dinâmica de símbolos, quantidades, tipos de ordem e lógica multi-símbolo — atuando 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

> As URLs de webhook são específicas da ação, não do utilizador. Tem de 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 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:

* Ordens stop-market / stop-limit acionadas
* Ativação de ordens trailing (início do trailing)
* Triggers de take-profit e stop-loss
* Condição de entrada dos bots 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="563"><figcaption></figcaption></figure>

<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="563"><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="563"><figcaption></figcaption></figure>

<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="563"><figcaption></figcaption></figure>

> **Cancelar** webhook — sempre disponível em todas as ordens e bots
>
> **Fechar posição** webhook — sempre disponível nos detalhes do bot DCA

Em resumo:

| Ação                            | Suportado? | Notas                                                                     |
| ------------------------------- | ---------- | ------------------------------------------------------------------------- |
| Cancelar ordem                  | ✅          | Sempre mostrado nos detalhes                                              |
| Acionar ordem stop              | ✅          | 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)                            |
| Bot Grid - entrada              | 🚫         | Ainda não suportado                                                       |

{% 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 específica do webhook da secção Webhooks do goodcryptoX
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 exemplo, stop-market 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 de estratégia do TradingView](https://docs.goodcrypto.app/goodcryptox-pt/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) dedicado para suportar negociações repetitivas com múltiplas ações, mas entretanto o bot DCA oferece 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
* **Entrada 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 **Entrada Compra**, abre uma posição long.
* Quando recebe **Entrada Venda**, abre uma posição short.
* 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**
  * O bot não aumentará nem reverterá a posição atual com sinais de Entrada
  * 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 o mais rápido possível
* **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 stop-market com condição de trigger = 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="563"><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="563"><figcaption></figcaption></figure>

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

Cole a URL específica do webhook da secção Webhooks do goodcryptoX. Deixe o campo Message tal 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

{% hint style="info" %}
O bot DCA mantém apenas uma posição de cada vez. Enquanto estiver em posição, ignora novos webhooks de entrada até a posição ser fechada.

Se quiser conseguir entrar em posições Long e Short no mesmo instrumento em paralelo - crie dois bots separados e envie Entrada Compra para um e Entrada Venda para o outro
{% endhint %}

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

### Tutoriais em vídeo

#### **Introdução ao trading com webhook**

#### **Utilizar o bot DCA com webhooks**

#### **Múltiplos take profits com webhooks**
