# 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 gatilho. 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](https://docs.goodcrypto.app/goodcryptox-pt/perp-dexs/funcionalidade-futura/bot-de-estrategia-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, webhooks só são aceitos dos servidores do TradingView — sem IPs personalizados ou fontes externas.\
> Se você precisar 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** possui 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)
* Gatilhos de take-profit e stop-loss&#x20;
* Condição de entrada de bots DCA

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><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%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" 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

Para resumir:

| Ação                            | Suportado? | Notas                                                                   |
| ------------------------------- | ---------- | ----------------------------------------------------------------------- |
| 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 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 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 por 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**, habilite a caixa de seleção **“Webhook URL”**
4. Cole a URL de webhook específica da seção Webhooks do goodcryptoX
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 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 é executada e o TP ou SL vinculado dispara, toda a negociação é concluída. 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 apresentaremos um dedicado [bot de estratégia do TradingView](https://docs.goodcrypto.app/goodcryptox-pt/perp-dexs/funcionalidade-futura/bot-de-estrategia-tradingview) 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 acionada por webhook.

#### Loop puramente via webhook

Para configurar um bot que entra numa 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 ambas **tomar**-**lucro** e **stop-loss**
4. Habilite **“Repetir ao fechar posição”**&#x20;

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

Uma vez que o bot é lançado, você verá as seguintes URLs de webhook em **Detalhes → Webhooks** do bot:

* **Entrar Buy** — abre uma posição Long
* **Entrar Sell** — 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 Buy**, ele abre uma posição long.
* Quando recebe **Entrar Sell**, ele abre uma posição short.
* O bot irá **responder apenas ao primeiro webhook de entrada** que receber enquanto estiver ocioso.
* Enquanto uma posição estiver aberta:
  * Qualquer sinal adicional de entrada será **ignorado**
  * O bot não aumentará nem reverterá a posição atual com sinais de Entry
  * Os únicos sinais aceitos são **fechar posição** ou um TP/SL acionado (se configurado)
* Uma vez que a posição é fechada (manualmente, por webhook ou por SL/TP), o bot se reinicia e aguarda o próximo webhook de Entry.

Esse 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 asap
* **Saída**: via webhook, ou TP/SL integrados baseados 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 baseados em preço como soluções de 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 dirigidos por sinal 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 única + múltiplos take profits (ressalto 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

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**Configuração no TradingView**

Crie quatro alertas:

1. Preço rompe a banda inferior → enviar para **Gatilho** URL de webhook
2. Preço volta 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%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

Nas **configurações do alerta**, habilite 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á — não é utilizado.

#### Exemplo 2: Estratégia repetitiva com bot DCA (Golden/Death Cross)

**Objetivo:** Entrar Long no Golden Cross, entrar 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 = desligada (defina para 0)
* Take Profit = 10%
* Stop loss = desligado
* Habilite: "Repetir no TP"

**Configuração no TradingView**

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

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

Se você quiser ser capaz de entrar em posições Long e Short no mesmo instrumento em paralelo - crie dois bots separados e envie Entrar Buy para um e Entrar Sell para o outro
{% endhint %}

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

### Tutoriais em vídeo

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

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **Usando o bot DCA com webhooks**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

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

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}