Webhooks

goodcryptoX te permite automatizar acciones de trading 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 "comprar 3 BTC"), goodcryptoX actualmente admite 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 para TradingView que admitirá instrucciones de estrategia completas vía webhooks, incluida la 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

Seguridad y acceso

  • 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.

  • Los webhooks están disponibles solo para usuarios con un PRO plan o superior.

Cómo funcionan los webhooks en goodcryptoX

  • Cada orden o bot acción tiene su propia URL de webhook dedicada

  • Debes crear primero la orden o el bot para obtener la URL (aparecerán en la sección Webhooks de los Detalles)

  • Enviar cualquier payload de webhook a esa URL activará la acción

Las URL de webhook son específicas de la acción, no del usuario. Debes crear un webhook por acción, por ejemplo, uno para entrada, uno para take profit, uno para stop loss, etc., para cada bot u orden

Acciones de órdenes y bots compatibles

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

  • Las órdenes stop-market / stop-limit se activan

  • Activación de órdenes trailing (inicio del trailing)

  • Activaciones de take-profit y stop-loss

  • Condición de entrada de bots DCA

Tras la creación, encontrarás todas las URL de webhook disponibles en los Detalles de tu orden o bot:

Cancelar webhook — siempre disponible en todas las órdenes y bots

Cerrar posición webhook — siempre disponible en los detalles del bot DCA

En resumen:

Acción
¿Compatible?
Notas

Cancelar orden

Siempre mostrado en detalles

Activar orden Stop

Debe seleccionarse webhook en la configuración

Activar orden Trailing

Inicio del trailing = webhook

Activar take profit / stop loss

Opcionalmente activado por webhook

Bot DCA - entrada

Entrada compra/venta vía webhook (debe configurarse en la creación)

Bot DCA - salida

Cerrar posición vía webhook (siempre disponible)

Bot Grid - entrada

🚫

Aún no compatible

Múltiples objetivos de take-profit con webhooks

Si configuras un grupo de take-profit usando webhook como método de activación, todos compartirán la misma URL de webhook. Cada vez que se active 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 los ajustes de la alerta, habilita la casilla “Webhook URL”

  4. Pega la URL de webhook específica desde la sección Webhooks de goodcryptoX

  5. Deja el campo de mensaje tal cual (cualquier contenido está bien; goodcryptoX ignora el payload por ahora)

  6. Guarda la alerta

Estrategias repetitivas (mediante bot DCA)

Una orden activada por webhook (por ejemplo, stop-market 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 dispara, la operación queda 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 introduciremos un bot de estrategia para TradingView dedicado para soportar 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 por webhook, salga por webhook y luego repita:

  1. Configura condición de entrada = webhook

  2. Configura órdenes de promediado = 0 (desactivar promediado)

  3. Desactiva tanto take-profit y stop-loss

  4. Habilita "Repetir al cerrar posición"

Una vez lanzado el bot, verás las siguientes URL de webhook en los Detalles → Webhooks del bot:

  • Entrar Compra — abre una posición Long

  • Entrar Venta — abre una posición Short

  • 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.

  • Cuando recibe Entrar Venta, abre una posición short.

  • 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 es ignorada

    • El bot no aumentará ni invertirá la posición actual con señales de Entrada

    • 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 indefinidamente un ciclo completo de entrada → salida → reinicio.

Modo puro de webhook vs configuraciones híbridas

El bot DCA admite múltiples capas de control que se pueden combinar para construir estrategias flexibles:

  • Entrada: vía webhook, señal o lo antes posible

  • Salida: vía webhook, o TP/SL incorporados basados en precio

  • Promediado: opcional; puede desactivarse

Puedes:

  • Ejecutar un bot completamente mediante señales webhook (entrada y salida)

  • Agregar TP/SL basados en precio como respaldo, incluso si usas salidas por webhook

  • Agregar órdenes de promediado para protección adicional

Esto hace posible diseñar:

  • Estrategias de bucle totalmente automatizadas (webhook puro)

  • Bots impulsados por señales con conmutaciones manuales

  • Configuraciones híbridas con salidas en múltiples capas

Ejemplos prácticos de estrategias con webhooks

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

Objetivo: Comprar cuando el precio rompa la banda inferior de Bollinger, vender progresivamente a medida que asciende.

Configuración en goodcryptoX

  • Crea una orden stop-market con condición de activación = webhook

  • Añade tres objetivos de take-profit. Activación de TP = webhook

Configuración en TradingView

Crea cuatro alertas:

  1. El precio rompe la banda inferior → enviar al Disparador URL de webhook

  2. El precio vuelve dentro de la banda → enviar a Disparador de Take Profit URL de webhook

  3. El precio cruza la banda media → enviar a Disparador de Take Profit URL de webhook

  4. El precio rompe la banda superior → enviar a Disparador de Take Profit URL de webhook

En los ajustes de la alerta, habilita la casilla “Webhook URL”

Pega la URL de webhook específica desde la sección Webhooks de goodcryptoX. Deja el campo Mensaje tal cual — 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 10% de beneficio o cuando RSI > 70 y repetir indefinidamente.

Configuración en goodcryptoX

Crear bot DCA

  • Condición de entrada = webhook

  • Promediado = apagado (ajustar a 0)

  • Take Profit = 10%

  • Stop loss = apagado

  • Habilitar: "Repetir en TP"

Configuración en TradingView

  • Crea tres alertas en el mismo gráfico:

    1. SMA50 cruza por encima de SMA200 → enviar a Entrar Compra webhook

    2. SMA50 cruza por debajo de SMA200 → enviar a Entrar Venta webhook

    3. RSI > 70 → enviar a Cerrar posición webhook

El bot DCA mantiene solo una posición a la vez. Mientras esté en posición, ignora nuevos webhooks de entrada hasta que la posición se cierre.

Si quieres poder entrar en posiciones Long y Short sobre el mismo instrumento en paralelo, crea dos bots separados y envía Entrar Compra a uno y Entrar Venta al otro

Resumen

Concepto
Descripción

Modelo de activación

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

Acceso

Requiere plan PRO o superior

Tutoriales en vídeo

Introducción al trading con webhooks

Uso del bot DCA con webhooks

Múltiples take-profits con webhooks

Última actualización