Webhook a MT5: envía señales JSON desde cualquier sistema

Advertencia de riesgo: Operar con CFD y otros productos apalancados es complejo y conlleva un alto riesgo de perder dinero rápidamente debido al apalancamiento. Los datos del sector indican que el 70–80% de las cuentas de negociación minoristas pierden dinero con estos productos. Advertencia de riesgo · Rentabilidad pasada.

El endpoint es agnóstico al origen: cualquier cosa capaz de emitir un POST HTTPS puede enviar señales, ya sea un escáner en Python, un bot en Node, un cron job o una automatización no-code. No hay ningún EA que instalar, ni MQL5 que escribir, ni VPS que mantener en línea. La conexión con MT5 corre en la nube de PipSync, y los webhooks de salida firmados reportan los eventos de vuelta a tu propio sistema para que puedas cerrar el ciclo de forma programática.

1. 1

   Crea tu cuenta de PipSync y elige un plan

   Regístrate en app.pipsync.io y suscríbete a un plan que cubra esta ruta (se requiere método de pago, cancela cuando quieras). Envía un payload de prueba y revisa cómo se interpretó en la página de Señales.

2. 2

   Conecta tu cuenta de MT5

   Agrega una cuenta desde Cuentas de trading → Añadir cuenta y selecciona MetaTrader 5. Cuando llegue una señal, asignas esta cuenta a la señal y la confirmas. Empieza con una cuenta demo.

3. 3

   Genera tu URL de webhook

   En el panel, ve a Ajustes → Avanzado → Alertas de TradingView y pulsa Generar URL de webhook. PipSync genera una URL única con un token secreto, que se muestra una sola vez: cópiala y guárdala como cualquier secreto. Si sospechas una filtración, genera una nueva desde el mismo lugar; las alertas recibidas aparecen en Alertas recientes.

4. 4

   Apunta tu sistema al endpoint

   Desde tu bot, escáner o script, envía un POST HTTPS con la carga JSON: instrument, direction, entry, sl y tp1 son obligatorios (sl y tp mayores que 0). Cualquier cliente HTTP funciona; no hay ningún SDK que instalar.

5. 5

   Define tus ajustes de riesgo

   Configura el tamaño de posición (riesgo por operación en %, lote mínimo y máximo) y un tope de operaciones abiertas máximas en PipSync. La carga no lleva tamaño de lote: un webhook de tu propio sistema nunca se opera automáticamente, así que cada señal espera tu confirmación en la página de Señales y estos ajustes se aplican cuando la confirmas.

6. 6

   Envía un payload de prueba

   Envía un payload de prueba y revisa Alertas recientes en Ajustes → Avanzado → Alertas de TradingView para ver cómo se interpretó. Después asigna tu cuenta MT5 a la señal en la página de Señales y confírmala a mano: un webhook de tu propio sistema siempre queda como señal para tu aprobación.

Tiempo de configuración típico: unos 12 minutos.

Una señal mínima es un objeto JSON plano con instrument, direction, entry, sl y tp1: { "instrument": "EURUSD", "direction": "buy", "entry": 1.0850, "sl": 1.0800, "tp1": 1.0950 }. direction acepta "buy" o "sell"; instrument debe coincidir con el nombre del instrumento en la lista de símbolos de MT5 de tu bróker; sl y tp1 son niveles de precio absolutos y deben ser mayores que 0.

Usa siempre JSON: un mensaje en texto plano se guarda siempre como señal para tu aprobación. Un webhook de tu propio sistema nunca se opera automáticamente: cada carga llega como señal a la página de Señales y la confirmas o la rechazas tú, y la salida la marcan el SL y el TP de la propia señal.

Cada origen de webhook obtiene una URL HTTPS única que contiene un token secreto: la URL en sí es la credencial. Eso mantiene el lado del emisor deliberadamente simple: sin flujo OAuth, sin firma de solicitudes, sin librería cliente. curl, un script de cinco líneas en Python o una función serverless pueden autenticarse todos de la misma manera.

Trata la URL como una contraseña. Mantenla fuera del código del lado cliente y de repositorios públicos, y genera una nueva en Ajustes → Avanzado → Alertas de TradingView si sospechas una filtración: cualquiera que tenga la URL puede enviar señales a tu cuenta y, si has activado el trading automático de TradingView, activar operaciones enviándole una alerta de TradingView. Una solicitud de cualquier otro sistema siempre espera tu revisión en la página de Señales, pero regenerar una URL filtrada debería ser tu primera respuesta.

Un puente basado en EA acopla tu automatización a una terminal MT5 en ejecución, normalmente un VPS de Windows que alquilas, parcheas y monitoreas, además de código MQL5 que mantienes. Si la terminal se cierra o el VPS se reinicia, tu estrategia queda fuera de línea. PipSync mueve la conexión con el bróker al lado servidor mediante un puente de API en la nube hacia MT5, así que no hay nada instalado en la terminal y nada que muera junto con una sesión de escritorio.

También desacopla tu elección de lenguaje del ecosistema de MetaQuotes. Tu escáner puede quedarse en Python, tu lógica de ejecución en Rust o Node; si puede emitir un POST HTTP, puede enviar señales. Los ajustes de riesgo como el tamaño de posición y el máximo de operaciones abiertas viven en PipSync, de modo que se aplican cuando asignas la señal a tu cuenta MT5 y la confirmas; un webhook de tu propio sistema solo crea una señal para revisar.

Suscribe tu propio endpoint a los webhooks de salida de PipSync y recibirás un POST JSON firmado en eventos como signal.received, trade.opened, trade.closed, trade.tp_hit y trade.sl_hit. Cada entrega lleva una cabecera X-PipSync-Signature (una marca de tiempo más un resumen HMAC-SHA256) para que puedas verificar la autenticidad antes de confiar en la carga; rechaza cualquier cosa cuya marca de tiempo tenga más de unos pocos minutos para bloquear repeticiones. Las entregas fallidas se reintentan hasta 5 veces con retroceso exponencial.

Para el sondeo y la conciliación también hay una API REST de lectura (GET /v1/signals y GET /v1/trades) descrita por una especificación OpenAPI 3.1 en /api/v1/openapi.json, de modo que puedes generar un cliente tipado para tu runtime. Las claves de API para la API de lectura forman parte del plan Enterprise; el panel mismo muestra cada señal interpretada y la orden resultante en todos los planes.

El nombrado de símbolos es el error de integración más común. El campo instrument debe coincidir exactamente con el nombre del instrumento tal como aparece en la lista de símbolos de MT5 de tu bróker, y los brókers usan habitualmente sus propias variantes de los nombres estándar: verifica contra la lista de símbolos del bróker y confirma con una señal de prueba.

La integración de MT5 de PipSync funciona tanto con el modo de cuenta hedging como con el de netting, maneja ejecuciones parciales y envía el stop-loss y el take-profit de la señal junto con la orden, de modo que la protección queda en el bróker y no en tu script. Si tu emisor puede generar ráfagas, ten en cuenta que las solicitudes pueden estar sujetas a límites: si recibes un HTTP 429, espera y reintenta con retroceso.