🔗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 [email protected] 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:

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

• 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

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

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)

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.

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"

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

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

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