Guía de Bots con Webhook de TradingView

Has construido una alerta en TradingView que se dispara exactamente cuando querrías entrar en una operación. El problema: una alerta es solo una notificación. Para cuando la ves y colocas la orden, el precio ya se movió — o estabas dormido y la perdiste por completo.

Un bot con webhook de TradingView cierra esa brecha. En lugar de notificarte a ti, la alerta notifica a una URL de webhook — una dirección web privada que pertenece a tu bot. El bot de señales de Freya escucha en esa dirección, y en el momento en que tu alerta se dispara, coloca la operación en tu exchange automáticamente. Tu lógica de gráficos permanece en TradingView; Freya se encarga de la ejecución.

Esta guía cubre los conceptos, la configuración paso a paso, y el conocimiento de fiabilidad, seguridad y resolución de problemas que mantiene la conexión funcionando cuando importa.

Cómo Funcionan las Alertas y los Webhooks de TradingView

Tres piezas componen el flujo.

La alerta es una condición que defines en un gráfico de TradingView: el precio cruzando un nivel, un indicador cambiando de dirección, un script personalizado disparándose. Por sí sola puede aparecer en pantalla, enviarte un correo o una notificación al móvil — todo lo cual sigue requiriendo que tú actúes.

El webhook es la opción de automatización. Cuando lo activas, TradingView envía un pequeño mensaje por internet a una URL que tú eliges en el instante en que la alerta se activa — la alerta hace una llamada telefónica en lugar de dejarte una nota.

El bot es el extremo receptor. El bot de señales de Freya expone una URL de webhook privada; cuando el mensaje llega, el bot ejecuta la acción para la que está configurado en tu cuenta de exchange conectada.

La cadena completa:

1. Tu condición del gráfico se cumple en TradingView
2. La alerta se dispara y TradingView llama a la URL de webhook de tu bot
3. Freya recibe la señal y tu bot coloca la orden en tu exchange
4. Tu bot gestiona entonces la posición según su configuración

El modelo mental clave: tu estrategia vive en TradingView; Freya es la capa de ejecución — la lógica de timing está enteramente dentro de tu alerta.

Qué Hace el Disparador de Webhook de Freya

En Freya, la ejecución por webhook la maneja el bot de señales — el tipo de bot descrito en el flujo de creación como "Ejecuta operaciones basadas en señales de webhook". A diferencia de un disparador basado en indicadores (RSI, EMA, etc.), el disparador de webhook no tiene timeframe ni condición configurada dentro de Freya — la decisión de cuándo disparar pertenece enteramente a tu alerta de TradingView. El trabajo de Freya es lo que sucede después.

Existen dos modos de webhook, y un bot usa uno u otro — no se pueden combinar:

• Webhook de TradingView (modo Señal Personalizada). Tu bot obtiene dos URLs: una URL de Webhook de Apertura y una URL de Webhook de Cierre. Un mensaje a la URL de Apertura abre una posición usando la configuración de órdenes que definiste en Freya — el monto de la operación y tu toma de ganancias y stop loss; un mensaje a la URL de Cierre la cierra.

• Modo Ratio de Riesgo. Tu bot obtiene una URL. El mensaje de la alerta es una pequeña carga JSON que lleva tus precios de toma de ganancias y stop loss; la entrada se ejecuta a mercado cuando llega la señal. En lugar de un monto de operación, defines un monto fijo de riesgo (anclado al stop loss, u opcionalmente a la toma de ganancias), y Freya dimensiona la posición automáticamente a partir de la distancia entre entrada y stop. No hay URL de Cierre porque las salidas se gestionan solas: la toma de ganancias se coloca como orden límite al precio exacto de tu señal, y el stop loss se ejecuta como orden a mercado cuando se activa.

Paso a Paso: Conecta TradingView con Tu Bot

Paso 1: Crea un Bot de Señales

En el flujo de Crear Bot de Freya, elige el tipo Bot de Señales, luego selecciona tu cuenta de exchange, par de trading y dirección — igual que con cualquier otro bot. El recorrido completo en Cómo Crear un Bot de Señales en Freya Finance cubre cada pantalla en detalle.

Paso 2: Elige Tu Modo de Señal

Elige Señal Personalizada si quieres configurar el monto de la operación, la toma de ganancias y el stop loss dentro de Freya y dejar que tus alertas simplemente digan "abre ahora" y "cierra ahora". Elige Ratio de Riesgo si tu estrategia produce una toma de ganancias y un stop loss por operación y quieres que el dimensionamiento se gestione automáticamente a partir de un monto fijo de riesgo.

Paso 3: Copia Tu(s) URL(s) de Webhook

En el paso de estrategia, Freya genera tu(s) URL(s) de webhook. Usa el botón de copiar — un solo carácter faltante hace la URL inservible. Puedes regenerar cualquier URL más tarde, lo que crea una nueva e invalida la anterior de inmediato.

Paso 4: Crea la Alerta en TradingView

En tu gráfico de TradingView, crea una alerta con la condición que representa tu entrada. En los ajustes de notificación de la alerta, activa la opción Webhook URL y pega la URL de tu bot — la URL de Apertura en modo Señal Personalizada, o la URL única en modo Ratio de Riesgo. Para salidas dirigidas por alertas en modo Señal Personalizada, crea una segunda alerta con tu condición de salida y apúntala a la URL de Cierre.

Paso 5: Configura el Mensaje de la Alerta

El mensaje de la alerta es la carga que TradingView entrega a tu bot. Usa exactamente el formato que proporciona la pantalla de configuración de tu bot — en modo Ratio de Riesgo, Freya muestra una Plantilla de Cuerpo JSON con botón de copia en un clic; tu alerta debe enviar esa estructura con tus valores de toma de ganancias y stop loss rellenados. No improvises: si el mensaje no coincide con lo que el bot espera, la señal se ignora en lugar de adivinarse.

Paso 6: Prueba Antes de Operar en Vivo

Nunca conectes un webhook y te desentiendas. Ejecuta al menos un ciclo completo de ida y vuelta con un monto pequeño:

1. Configura una condición de alerta que sabes que se activará pronto (el precio cruzando un nivel que está a punto de tocar)
2. Deja que se dispare, luego revisa el registro de actividad de tu bot buscando el evento de señal entrante
3. Confirma que la posición se abrió en tu exchange con el tamaño que esperabas
4. Activa el cierre (señal a la URL de Cierre, o la toma de ganancias/stop loss en modo Ratio de Riesgo) y confirma que la posición realmente se cerró

Solo después de un ciclo limpio deberías conectar tu estrategia real y tu tamaño real.

Un Ejemplo Práctico: Dimensionamiento en Ratio de Riesgo

Supón que defines un riesgo fijo de $20 por operación, anclado al stop loss. Tu alerta de TradingView se dispara con BTC en $100,000, llevando en su mensaje un stop loss de $98,000 y una toma de ganancias de $104,000.

• Entrada: a mercado, ejecutada a $100,000
• Distancia al stop loss: $2,000 por BTC (2%)
• Tamaño de posición: $20 de riesgo ÷ $2,000 por BTC = 0.01 BTC (unos $1,000 de exposición)
• Toma de ganancias: orden límite a $104,000 — si se ejecuta, la ganancia es 0.01 × $4,000 = $40, una recompensa de 2:1 por los $20 arriesgados
• Stop loss: orden a mercado si $98,000 se activa — aproximadamente los $20 que elegiste, más comisiones, y posiblemente algo más en un movimiento rápido, ya que un stop activado se ejecuta a mercado

Ya esté tu stop a 1% o a 5% de distancia, el monto en dólares en riesgo se mantiene en $20 porque el tamaño se ajusta — esa consistencia es todo el sentido del modo Ratio de Riesgo.

Fiabilidad: Con Qué Puedes Contar y Con Qué No

La automatización es tan fiable como su eslabón más débil, y con los bots de webhook ese eslabón suele estar fuera de Freya.

Requisitos del plan de TradingView. Las notificaciones por webhook no están incluidas en todos los planes de TradingView, y los límites y la expiración de alertas también varían según el nivel. Una alerta que no puede enviar webhooks falla en silencio desde la perspectiva del bot — verifica las opciones de alertas de tu plan antes de construir tu configuración sobre ellas.

Los retrasos y las caídas ocurren. El marketplace de Freya etiqueta las estrategias basadas en webhook con una advertencia de señal externa: las operaciones se activan por señales de TradingView o webhooks, y los retrasos o caídas en la fuente son posibles. Si TradingView tiene un incidente, tu alerta nunca se dispara y el bot — correctamente — no hace nada. Freya ejecuta lo que llega; no puede ejecutar lo que nunca llega.

Las señales de cierre perdidas son el filo más afilado. En modo Señal Personalizada, si tu señal de apertura llega pero tu señal de cierre nunca lo hace, la posición queda abierta. Un stop loss configurado en los ajustes de órdenes de tu bot es un respaldo que no depende de que llegue un segundo webhook — vale la pena tenerlo en la mayoría de las configuraciones.

Las alertas de un solo disparo dejan de funcionar. Una alerta de TradingView configurada para activarse "Solo una vez" queda agotada tras una señal hasta que la recrees. Para una estrategia recurrente, elige una opción de activación repetitiva y revisa la fecha de expiración de la alerta.

Seguridad: Tu URL de Webhook Es un Secreto

Una URL de webhook es la llave para activar tu bot. No hay contraseña encima de ella — poseer la URL es la credencial:

• Nunca compartas ni publiques una URL de webhook — ni en una captura de pantalla de los ajustes de la alerta, ni en un layout de gráfico compartido, ni en un mensaje de chat pidiendo ayuda. Difumínala o recórtala primero.
• Pégala solo en herramientas que tú controles, como tus propias alertas de TradingView.
• Regenera de inmediato si sospechas exposición — la URL antigua deja de funcionar al instante. Luego actualiza tus alertas con la nueva.

Resolución de Problemas: La Alerta Se Disparó pero No Hubo Operación

La causa es casi siempre una de una lista corta — revísala en orden:

1. ¿El bot está en ejecución? Un bot pausado o detenido ignora las señales entrantes — el culpable más frecuente.
2. ¿URL correcta, ranura correcta? Una alerta de entrada apuntada a la URL de Cierre nunca abrirá una posición. Confirma Apertura vs Cierre, y confirma que la URL se pegó completa.
3. ¿Regeneraste recientemente? Regenerar invalida la URL antigua al instante. Si tu alerta aún conserva la anterior, sus mensajes no llegan a ningún lado.
4. ¿El formato del mensaje coincide? Especialmente en modo Ratio de Riesgo, el mensaje debe coincidir con la estructura JSON de la pantalla de configuración de tu bot. Un mensaje malformado se ignora.
5. ¿Tu plan de TradingView puede enviar webhooks siquiera? Si no, la alerta se activa visualmente pero ningún mensaje se envía. Revisa también si la alerta expiró o estaba configurada como "Solo una vez".
6. Mínimos del exchange. Si tu monto configurado — o el tamaño auto-calculado de Ratio de Riesgo — cae por debajo del tamaño mínimo de orden del par, el exchange rechaza la orden.

Para problemas de estado del bot más allá de los webhooks, consulta ¿Por Qué Mi Bot No Está Operando?

Preguntas Frecuentes

¿Necesito un plan de pago de TradingView para usar bots de webhook?

Si TradingView es tu fuente de señales, el nivel del plan importa: las notificaciones por webhook no forman parte de todos los planes, y las alertas del nivel gratuito tienen límites y reglas de expiración más estrictos. Antes de construir tu automatización sobre alertas, abre la comparativa de planes de TradingView y confirma que las notificaciones por webhook están incluidas en el tuyo — y revisa tu cupo de alertas si operas varios pares. Dicho esto, al lado del bot no le importa quién envía el mensaje. El bot de señales de Freya responde a llamadas de webhook de cualquier fuente — otra plataforma de gráficos, tu propio script, o cualquier herramienta capaz de enviar un webhook. Así que un plan de pago de TradingView es un requisito de la función de webhook de TradingView, no de Freya. Si tu plan no incluye webhooks, tus alternativas son actualizar el plan, cambiar de fuente de señales, o construir la lógica dentro de Freya con disparadores basados en indicadores en lugar de señales externas.

¿Cuál es la diferencia entre las URLs de webhook de Apertura y de Cierre?

En modo Señal Personalizada, tu bot expone dos URLs separadas con dos trabajos distintos. Un mensaje a la URL de Webhook de Apertura abre una posición usando la configuración de órdenes que definiste en Freya — el monto de la operación más cualquier toma de ganancias y stop loss que hayas establecido. Un mensaje a la URL de Webhook de Cierre cierra la posición que el bot tiene abierta. No son intercambiables — una alerta de entrada apuntada a la URL de Cierre nunca abrirá una operación. El modo Ratio de Riesgo funciona distinto — hay una sola URL, usada para la señal de entrada, y no existe URL de Cierre porque la salida se gestiona automáticamente con la toma de ganancias y el stop loss que van en el mensaje del webhook. Ambas URLs pueden copiarse y regenerarse de forma independiente; regenerar crea una URL nueva e invalida la anterior al instante, así que actualiza la alerta de TradingView correspondiente después.

¿Puede mi alerta de TradingView establecer la toma de ganancias y el stop loss?

Sí — para eso existe exactamente el modo Ratio de Riesgo. En ese modo, el mensaje de tu alerta es una pequeña carga JSON que lleva los precios de toma de ganancias y stop loss, y la pantalla de configuración de Freya proporciona la Plantilla de Cuerpo JSON para copiar en tu alerta. Cuando la señal llega, la entrada se ejecuta al precio de mercado, y las salidas se colocan a partir de los valores de tu señal: la toma de ganancias como orden límite al precio exacto que enviaste, y el stop loss como orden a mercado cuando su precio de activación se alcanza. Como el stop se ejecuta a mercado, puede sufrir deslizamiento en un movimiento rápido — como cualquier orden stop. En modo Señal Personalizada, el webhook no puede establecer niveles de salida; la toma de ganancias y el stop loss provienen de la configuración de órdenes que defines dentro de Freya, y tus alertas se limitan a decir cuándo abrir y cuándo cerrar.

¿Es seguro pegar mi URL de webhook en TradingView?

Pegar la URL en tu propia alerta de TradingView es el uso previsto — es la integración funcionando como fue diseñada. El riesgo real es la exposición, no el pegado en sí. Una URL de webhook no tiene contraseña encima: quien posea la URL puede activar esa acción en tu bot. Las vías de filtración habituales son mundanas: una captura de pantalla de los ajustes de la alerta compartida en un chat, una publicación pública pidiendo ayuda, o un layout de gráfico compartido. Trata cada URL como una contraseña: mantenla fuera de capturas de pantalla, no la compartas con nadie, y pégala solo en herramientas que tú personalmente controles. Si alguna vez sospechas que alguien más ha visto una URL, regenérala de inmediato — la antigua deja de funcionar en el momento en que se crea la nueva — y luego actualiza tu alerta con el reemplazo antes de que se dispare tu próxima señal.

¿Por qué mi alerta se disparó pero no ocurrió ninguna operación?

Empieza por el bot mismo: un bot pausado o detenido ignora las señales por completo — la causa más común. Después, verifica la fontanería: la alerta debe contener la URL correcta y completa (Apertura, no Cierre, para entradas) — y si regeneraste hace poco, la alerta podría seguir apuntando a la URL muerta. Luego revisa el mensaje: particularmente en modo Ratio de Riesgo, la carga tiene que coincidir con la plantilla JSON de la pantalla de configuración de tu bot, o la señal se ignora. Del lado de TradingView, confirma que tu plan realmente envía webhooks y que la alerta no expiró ni gastó su único disparo de "Solo una vez". Finalmente, si tu monto — o el tamaño auto-calculado de Ratio de Riesgo — está por debajo del mínimo del exchange para el par, la orden se rechaza. El registro de actividad de tu bot te dice qué lado falló: una señal registrada significa un problema de ejecución; ninguna entrada en el registro significa que la señal nunca llegó.

¿Mis señales tienen que venir de TradingView?

No. TradingView es la fuente más popular porque su sistema de alertas es flexible y está basado en gráficos, pero el bot de señales de Freya responde a llamadas de webhook sin importar el origen. Cualquier herramienta que pueda enviar un webhook funciona: otra plataforma de gráficos, un script personalizado, un screener con notificaciones por webhook, o un sistema de señales propio. El contrato es el mismo en todos los casos — llamar a la URL de Apertura o de Cierre en modo Señal Personalizada, o enviar la carga JSON esperada con los valores de toma de ganancias y stop loss a la URL única en modo Ratio de Riesgo. Dos precauciones aplican a cualquier fuente. Primera, la cuestión de fiabilidad no desaparece: tu bot solo puede ejecutar señales que realmente llegan, así que el tiempo de actividad de tu fuente es el de tu estrategia. Segunda, la regla de seguridad es universal — sea cual sea la herramienta, la URL de webhook va solo en sistemas que controlas y en los que confías.

Hacia Dónde Ir Después

Un bot de webhook es tan bueno como la estrategia que lo alimenta. Pon a prueba tu lógica de señales contra el histórico con Cómo Hacer Backtest de Tu Estrategia de Trading de Criptomonedas, y lee el recorrido completo en Cómo Crear un Bot de Señales en Freya Finance si te saltaste algún detalle de la configuración. Si prefieres construir la lógica de entrada dentro de Freya, la Guía de Estrategia de Bots DCA cubre ese enfoque en profundidad. Y para preguntas sobre custodia y permisos de claves API, consulta ¿Está Seguro Mi Dinero en Freya Finance?