# Webhooks

goodcryptoX te permite automatizar el trading en DEX mediante webhooks de TradingView: un mecanismo potente para activar órdenes y acciones de bots directamente desde tus señales.

A diferencia de algunas implementaciones que tratan los webhooks como una API programable (donde envías comandos parametrizados como "buy 3 BTC"), goodcryptoX actualmente soporta un modelo basado en disparadores. Cada webhook simplemente activa una acción predefinida en una orden o bot específico: no se interpretan parámetros ni comandos.

En un futuro cercano, lanzaremos un nuevo bot de estrategia de TradingView que soportará instrucciones completas de estrategia vía webhooks, incluyendo selección dinámica de símbolos, cantidades, tipos de órdenes y lógica multi-símbolo — actuando efectivamente como una capa de API. Mantente atento

> Por ahora, los webhooks solo se aceptan desde los servidores de TradingView — no se permiten IPs personalizadas ni fuentes externas.\
> Si necesitas usar una fuente de webhook personalizada, contáctanos en <support@goodcrypto.app> para solicitar acceso.

### Cómo funcionan los webhooks en goodcryptoX

* Cada orden o bot **acción** tiene su propia URL de webhook dedicada
* Debes crear la orden o el bot primero para obtener la URL (aparecerán en la **Webhooks** sección de los **Detalles**)
* Enviar **cualquier** payload de webhook a esa URL activará la acción

Aquí tienes una vista general en vídeo:

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

> Las URL de webhook son específicas por acción. Debes crear un webhook por acción, p. ej. uno para entrada, uno para take profit, uno para stop loss, etc. para cada bot u orden

### Acciones de ordenes y bots soportadas

Si quieres que tu orden o bot sea **disparado por un webhook**, debes seleccionar webhook como la **condición de disparo durante la configuración**. Esto se aplica a:

* Las órdenes limit disparan
* Activación de orden trailing (inicio del trailing)
* Disparadores de take-profit y stop-loss&#x20;
* Condición de entrada del bot DCA

> **Cancelar** webhook — siempre disponible en todas las órdenes y bots
>
> **Cerrar posición** webhook — siempre disponible en los detalles del bot DCA

<figure><img src="https://485515438-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>

Después de la creación, encontrarás todas las URLs de webhook disponibles en la **Detalles** de tu orden o bot:

<figure><img src="https://485515438-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>

Para resumir:

| Acción                           | ¿Soportado? | Notas                                                         |
| -------------------------------- | ----------- | ------------------------------------------------------------- |
| Cancelar orden                   | ✅           | Siempre se muestra en detalles                                |
| Disparar orden Limit             | ✅           | Debe seleccionarse webhook en la configuración                |
| Activar orden Trailing           | ✅           | Inicio de trailing = webhook                                  |
| Disparar take profit / stop loss | ✅           | Opcionalmente activado por webhook                            |
| Bot DCA - entrada                | ✅           | Entrada compra/venta vía webhook (debe configurarse al crear) |
| Bot DCA - salida                 | ✅           | Cerrar posición vía webhook (siempre disponible)              |

{% hint style="info" %}
**Múltiples objetivos de take-profit con webhooks**

Si configuras un grupo de take-profit usando webhook como método de disparo, todos compartirán la misma URL de webhook. Cada vez que se dispare el webhook, se ejecutará la siguiente orden TP en la secuencia — una por una.
{% endhint %}

### Cómo configurar alertas en TradingView

Una vez que hayas creado tu orden o bot en goodcryptoX y copiado la URL de webhook para una acción específica, así es como la vinculas a tus alertas de TradingView:

1. Ve a tu gráfico en TradingView
2. Crea una nueva alerta basada en tu estrategia, indicador o condición
3. En la **configuración de la alerta**, habilita la casilla **“Webhook URL”**
4. Pega la URL de webhook específica desde la **Webhooks disponibles** sección
5. Deja el **campo de mensaje** tal cual (cualquier contenido está bien — goodcryptoX ignora el payload por ahora)
6. Guarda la alerta

### Estrategias repetitivas (vía bot DCA)

Una orden activada por webhook (p. ej. limit con TP y SL) es una **configuración de una sola vez**. Una vez que la orden se ejecuta y el TP o SL vinculado se activa, la operación completa. Si quieres que esta estructura **se repita automáticamente**, eso no es posible con órdenes — pero sí es alcanzable ahora usando el bot DCA.

Pronto presentaremos un bot de estrategia dedicado para TradingView que soporte operaciones repetitivas con múltiples acciones, pero mientras tanto, el bot DCA ofrece una forma flexible de repetir tu estrategia impulsada por webhooks.

#### Bucle puro de webhooks

Para configurar un bot que entre en una posición con un webhook, salga con un webhook y luego se repita:

1. Establece **condición de entrada** = webhook
2. Establece **órdenes de promediación** = 0 (desactivar promediación)
3. Desactiva ambos **take**-**profit** y **stop-loss**
4. Habilita **"Repetir al cerrar posición"**

<figure><img src="https://485515438-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>

Una vez lanzado el bot, verás las siguientes URLs de webhook bajo los **Detalles → Webhooks** del bot:

* **Entrar Compra** — abre una posición Long
* **Cerrar posición** — cierra la posición activa (long o short)
* **Cancelar** — detiene el bot

**Lógica de ejecución**

* Cuando el bot recibe **Entrar Compra**, abre una posición long.
* El bot **solo responderá al primer webhook de entrada** que reciba mientras esté inactivo.
* Mientras una posición esté abierta:
  * Cualquier señal de entrada adicional será **ignorada**
  * Las únicas señales aceptadas son **cerrar posición** o un TP/SL activado (si está configurado)
* Una vez que la posición se cierra (manualmente, por webhook o por SL/TP), el bot se reinicia y espera el siguiente webhook de Entrada.

Este bucle continúa mientras el bot permanezca activo, permitiéndote repetir un ciclo completo entrada → salida → reinicio indefinidamente.

#### Modo puro de webhook vs configuraciones híbridas

El bot DCA soporta múltiples capas de control que pueden combinarse para construir estrategias flexibles:

* **Entrada**: vía webhook, señal o instantánea
* **Salida**: vía webhook, o TP/SL incorporados basados en precio
* **Promediación**: opcional; puede desactivarse

Puedes:

* Ejecutar un bot completamente mediante señales de webhook (entrada y salida)
* Agregar TP/SL basados en precio como respaldo, incluso si usas salidas por webhook
* Agregar órdenes de promediación para protección adicional

Esto permite diseñar:

* Estrategias de bucle totalmente automatizadas (webhook puro)
* Bots impulsados por señales con conmutaciones manuales de seguridad
* Configuraciones híbridas con salidas en múltiples capas

### Ejemplos prácticos de estrategia con webhooks

#### Ejemplo 1: Orden única + múltiples take profits (rebote en Bandas de Bollinger)

**Objetivo:** Comprar cuando el precio atraviese la banda inferior de Bollinger, vender progresivamente a medida que sube.

**Configuración en goodcryptoX**

* Crea una orden limit con condición de disparo = webhook
* Agrega tres objetivos de take-profit. Disparador de TP = webhook

<figure><img src="https://485515438-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>

**Configuración en TradingView**

Crea cuatro alertas:

1. El precio atraviesa la banda inferior → enviar al **Disparador** URL de webhook de la orden principal
2. El precio vuelve dentro de la banda → enviar al **Disparador de Take Profit** URL de webhook de la orden principal
3. El precio cruza la banda media → enviar al **Disparador de Take Profit** URL de webhook de la orden principal
4. El precio atraviesa la banda superior → enviar al **Disparador de Take Profit** URL de webhook de la orden principal

<figure><img src="https://485515438-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>

En la **configuración de la alerta**, habilita la casilla **“Webhook URL”**

Pega la URL de webhook específica desde la **Webhooks disponibles** sección. Deja el campo Mensaje tal como está — no se usa.

#### Ejemplo 2: Estrategia repetitiva con bot DCA (Golden/Death Cross)

**Objetivo:** Entrar long en Golden Cross, entrar short en Death Cross. Salir con un 10% de beneficio o cuando RSI > 70 y repetir para siempre.

**Configuración en goodcryptoX**

Crear bot DCA

* Condición de entrada = webhook
* Promediación = desactivada (ajustar a 0)
* Take Profit = 10%
* Stop loss = desactivado
* Habilitar: "Repetir en TP"

**Configuración en TradingView**

* Crea tres alertas en el mismo gráfico:
  1. SMA50 cruza por encima de SMA200 → enviar al **Entrar Compra** webhook
  2. SMA50 cruza por debajo de SMA200 → enviar al **Entrar Venta** webhook
  3. RSI > 70 → enviar al **Cerrar posición** webhook

### Resumen

| Concepto               | Descripción                                                             |
| ---------------------- | ----------------------------------------------------------------------- |
| Modelo de disparo      | Cada acción tiene su propia URL de webhook                              |
| Flujo de configuración | Crear orden → copiar URL de webhook → pegar en la alerta de TradingView |
| Estrategia repetitiva  | Usar bot DCA con repetición habilitada                                  |