AlgoVesta › Glosario › Webhook

Señales y automatización

Webhook

Un webhook es una solicitud HTTP automatizada que una aplicación envía a una URL en otra aplicación en el momento en que ocurre un evento; en trading, TradingView envía un webhook a una plataforma de automatización cuando se dispara una alerta de estrategia o indicador, para que la orden pueda colocarse sin que nadie haga clic en un botón.

Por qué importa

Las alertas por correo electrónico, notificación de aplicación o sonido todavía necesitan que un humano actúe sobre ellas. Un webhook lleva el cuerpo del mensaje de la alerta directamente a la plataforma de ejecución, que es lo que convierte una estrategia de TradingView en una automatizada. El cuerpo del mensaje está bajo tu control: puede ser un texto fijo como "BTCUSDT LONG" o un payload JSON con marcadores de posición que TradingView rellena en el momento de la alerta (símbolo, precio, acción, tamaño de posición). La plataforma en el extremo receptor analiza ese cuerpo, lo comprueba contra tus reglas y coloca la operación.

Cómo lo gestiona AlgoVesta

Cada estrategia de AlgoVesta obtiene su propia URL de webhook que contiene un token secreto; la pegas en el campo "Webhook URL" de la alerta de TradingView y pones la plantilla JSON del panel en el cuadro de mensaje. Las solicitudes entrantes se aceptan para ejecución en vivo solo cuando la fuente puede verificarse, ya sea porque la solicitud proviene de las direcciones IP publicadas de TradingView o de una IP que has incluido en tu lista blanca; cualquier otra cosa se registra pero no se opera. El payload se analiza en símbolo, lado, indicio de entrada, stop-loss y take-profit, y luego se enruta al destino que elegiste para esa estrategia: una cuenta de exchange de cripto o una cuenta de MetaTrader 5. Las salidas de estrategia ("flat") cierran la posición abierta en lugar de abrir el lado opuesto, y la misma lógica se ejecuta en modo paper para que puedas probar la alerta de extremo a extremo antes de operar en vivo. Una señal se recibe y se analiza en bastante menos de 100 ms; en promedio, de extremo a extremo, la orden llega al mercado en aproximadamente 4,1 seconds en los exchanges de cripto y aproximadamente 1,2 seconds en MT5. Los pasos de configuración están en la página bot de TradingView y en la guía de configuración de webhooks.

Ejemplo

Mensaje de alerta: {"symbol":"{{ticker}}","side":"buy","price":{{close}},"stop_loss":{{plot_0}},"take_profit":{{plot_1}}}. Cuando la estrategia se dispara en el gráfico de ETHUSDT, TradingView reemplaza los marcadores de posición y publica el JSON en la URL de la estrategia. AlgoVesta abre la posición larga con el margen configurado de $100, coloca el stop y el objetivo a partir de los dos plots, y muestra la operación en el panel en cuestión de segundos.

Errores frecuentes

En la práctica

Bot de TradingView →