Alertas de TradingView a MT5, sin EA ni VPS

TradingView puede enviar una alerta a una URL, pero no puede agregar un encabezado Authorization, así que no puede llamar a una API normal. La respuesta habitual es un Expert Advisor en un VPS con Windows, o un puente de pago. fxapis te da en su lugar una URL de alerta secreta: pégala en una alerta de TradingView, y las alertas que se disparan se convierten en órdenes en tu cuenta de MT5. Nosotros ejecutamos la terminal; nada tuyo tiene que quedarse encendido.

TradingView alert fires
   → POST https://api.fxapis.com/hooks/tradingview/<secret>     answered at once (202)
   → fxapis places the order on your MT5 account(s)             the same path as POST /v1/…/orders/market
   → the alert and its result appear under TradingView in the console

Es decir: la alerta se dispara, TradingView hace un POST a la URL secreta y recibe 202 de inmediato; fxapis envía la orden a tu cuenta (o cuentas) de MT5 por el mismo camino que POST /v1/…/orders/market; y la alerta y su resultado aparecen en TradingView, en la consola.

Lo que necesitasCopiar el enlace

• Un workspace de fxapis con una cuenta de MT5 conectada (Conecta cuentas de MT5). Para alertas que deben actuar en menos de un segundo, configura la cuenta como siempre conectada: una cuenta que se pone en línea a demanda primero tiene que conectarse, lo que tarda unos 10 segundos según nuestra medición.
• Un plan de TradingView que incluya alertas por webhook —la página de precios de TradingView lista las notificaciones por webhook en sus planes de pago, no en Basic— y la verificación en dos pasos activada en tu cuenta de TradingView: TradingView solo envía webhooks desde cuentas con 2FA (About webhooks). Ambas cosas revisadas el 30 de septiembre de 2026.

1. Crea un hookCopiar el enlace

En la consolaCopiar el enlace

Abre Console → TradingView → Create a TradingView hook, y luego:

1. Ponle de nombre (Name) la estrategia o el gráfico al que sirve.
2. Elige la cuenta. Con varias cuentas, cada alerta envía una orden multicuenta; esto necesita un plan con órdenes multicuenta.
3. Define el volumen predeterminado en lotes. Las alertas que no envían volumen lo usan.
4. Indica cómo nombra tu broker los símbolos: un mapa de símbolos (XAUUSD=XAUUSD.a, uno por línea) y/o un sufijo agregado a todos los demás símbolos (.a, m, .pro…).
5. Deja Only from TradingView activado, a menos que tú mismo envíes alertas de prueba.

La consola muestra entonces la URL, una sola vez, con mensajes listos para pegar. Cópiala ahora: solo guardamos un hash, así que no puede volver a mostrarse. Si la pierdes, rota el hook para obtener una nueva.

Crear y cambiar hooks requiere un owner o admin del workspace: la URL de un hook puede abrir posiciones, así que exige el mismo nivel que crear una clave de trading.

Con la APICopiar el enlace

Con una clave que tenga trading:execute:

curl -sS -X POST "https://api.fxapis.com/v1/alert-hooks" \
  -H "Authorization: Bearer $FXAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gold breakout",
    "accountIds": ["2b0c7c1e-5d0b-4d8e-9a53-0e6f3b1c9a10"],
    "defaults": {
      "volume": "0.10",
      "deviationPoints": 30,
      "symbolMap": { "XAUUSD": "XAUUSD.a" },
      "symbolSuffix": "",
      "stripExchangePrefix": true,
      "allowClose": true,
      "onlyTradingViewIps": true
    }
  }'

{
  "data": {
    "id": "8f1d…",
    "name": "Gold breakout",
    "url": "https://api.fxapis.com/hooks/tradingview/3q2-7ZkT0d8m1sQe9yVbW4nX6pLr5aHcUgJf0oKxQx4w",
    "urlHint": "https://api.fxapis.com/hooks/tradingview/…Qx4w",
    "enabled": true,
    "…": "…"
  }
}

url aparece en esta respuesta y en POST /v1/alert-hooks/{id}/rotate, y en ningún otro lugar. Todos los demás endpoints muestran urlHint.

2. Configura la alerta en TradingViewCopiar el enlace

3. MensajesCopiar el enlace

Hay mensajes de alerta listos para pegar, para indicadores y estrategias, en JSON o texto plano, en fxapis-integrations, junto con un flujo de n8n que convierte un webhook de TradingView en una orden; la guía paso a paso (en inglés) cubre ambos.

Un mensaje puede ser JSON o una línea de texto; TradingView envía JSON como application/json y todo lo demás como text/plain, y fxapis lee ambos.

Indicadores y dibujosCopiar el enlace

Una alerta de indicador no sabe nada de posiciones, así que envía una acción fija. Crea una alerta por dirección:

{ "action": "buy", "symbol": "{{ticker}}", "id": "{{ticker}}-{{timenow}}" }

{ "action": "sell", "symbol": "{{ticker}}", "id": "{{ticker}}-{{timenow}}" }

Agrega niveles o un volumen si la alerta los conoce:

{ "action": "buy", "symbol": "{{ticker}}", "volume": "0.20", "sl": "2310.5", "tp": "2385", "id": "{{ticker}}-{{timenow}}" }

EstrategiasCopiar el enlace

Una sola alerta cubre cada entrada, salida y reversión de una estrategia:

{
  "action": "{{strategy.order.action}}",
  "symbol": "{{ticker}}",
  "position": "{{strategy.market_position}}",
  "prev_position": "{{strategy.prev_market_position}}",
  "id": "{{strategy.order.id}}-{{timenow}}"
}

{{strategy.order.action}} por sí solo no puede distinguir una salida de una entrada: cerrar un long es un sell. Por eso, cuando position está presente, decide la posición después de la orden:

Las salidas parciales no se operan porque no hay una única traducción honesta a MT5: en una cuenta hedging, un "vende 1 de 3" podría cerrar parte de una posición o abrir una cobertura, y adivinar mal es peor que no hacer nada. Sal por completo, o deja que los stops tomen ganancias parciales.

Texto planoCopiar el enlace

Acción, símbolo, volumen opcional y luego pares key=value opcionales:

buy {{ticker}} 0.10
sell {{ticker}} 0.10 sl=1.1050 tp=1.0900 id={{timenow}}
close {{ticker}}
close_all

CamposCopiar el enlace

Los números se pueden enviar como números JSON o como strings. Placeholders que podrías usar: {{ticker}}, {{exchange}}, {{close}}, {{time}}, {{timenow}}, {{interval}}, y en estrategias {{strategy.order.action}}, {{strategy.order.contracts}}, {{strategy.order.price}}, {{strategy.order.id}}, {{strategy.order.comment}}, {{strategy.market_position}}, {{strategy.prev_market_position}}, {{strategy.position_size}}.

SímbolosCopiar el enlace

En orden:

1. Se quita el prefijo del exchange: OANDA:XAUUSD pasa a ser XAUUSD (a menos que lo desactives).
2. Mapa de símbolos: si el mapa nombra el símbolo, se usa su valor exactamente: XAUUSD → XAUUSD.a.
3. Sufijo: si no, se agrega el sufijo: con .a, EURUSD → EURUSD.a.

El símbolo en el que se resolvió la alerta aparece en cada entrega, así que un mapeo equivocado es fácil de detectar.

CierresCopiar el enlace

Cerrar actúa sobre las posiciones que tiene la cuenta, no solo sobre las que abrió una alerta: MT5 no registra quién abrió una posición de una forma confiable, y que "cerrar XAUUSD" signifique "cerrar el XAUUSD que veo" es lo que esperan los traders. Primero se leen las posiciones directamente de la terminal. Cada posición cerrada es su propia orden en tu historial. Si no hay nada abierto, la alerta se registra como ignored.

Desactiva Act on close alerts ("allowClose": false) si sales solo con stops: las acciones de cierre se registran entonces como ignored, y las reversiones también se ignoran.

Cerrar nunca se rechaza por los límites de tu plan: siempre puedes quedar sin posiciones.

DuplicadosCopiar el enlace

TradingView completa {{timenow}} una sola vez, cuando se dispara la alerta, así que un reenvío de una alerta lleva el mismo id y una alerta nueva, uno nuevo. fxapis envía cada id una vez: una repetición se responde con 200 y "status": "duplicate", se registra y no se opera, incluso si las copias llegan en el mismo instante.

Sin un id, el mismo mensaje dos veces en 60 segundos se trata como una sola alerta. Eso también significa que dos alertas idénticas realmente distintas dentro de un minuto se operan una vez: otra razón para incluir un id.

SeguridadCopiar el enlace

• La URL es la credencial. 32 bytes aleatorios, mostrada una vez, guardada solo como hash SHA-256. Cualquiera que tenga la URL puede operar las cuentas del hook, así que mantenla fuera de capturas de pantalla y plantillas compartidas. Rótala si se filtra: la URL anterior deja de funcionar de inmediato.
• Only from TradingView (activado por defecto) rechaza cualquier solicitud que no se envíe desde las direcciones de webhook publicadas por TradingView: 52.89.214.238, 34.212.75.30, 54.218.53.128, 52.32.178.7. Desactívalo solo para enviar alertas de prueba desde tu propia máquina.
• Pausa un hook para rechazar sus alertas sin tocar TradingView. Elimínalo para terminar la URL para siempre; sus órdenes se quedan en tu historial.
• Las alertas pasan exactamente por las mismas comprobaciones que una orden de la API: la cuenta debe poder operar, tu plan debe permitirlo y no se envía nada mientras el trading esté desactivado para tu workspace.
• No pongas secretos en los mensajes de las alertas. El mensaje se guarda (hasta 2 KB) con cada entrega para que veas qué llegó; si pegas la URL del hook en un mensaje, se quita antes de guardarlo.

Solución de problemasCopiar el enlace

Las alertas que llegan a un hook aparecen en Console → TradingView → tu hook (o en GET /v1/alert-hooks/{id}/deliveries) durante 30 días, con un estado y un motivo en palabras simples. Por encima de 30 alertas por minuto, solo se registra una fila por minuto:

Lo que ve TradingView:

Causas comunes:

• No aparece nada en la lista: la alerta no nos llegó. Revisa que la URL se haya pegado completa, que Webhook URL esté marcado, y el log de alertas de TradingView. Una URL rotada o eliminada responde 404.
• rejected, no viene de las direcciones de TradingView: enviaste una prueba con curl u otra herramienta. Desactiva Only from TradingView mientras pruebas.
• rejected, la cuenta está fuera de línea o no está lista: la cuenta no estaba conectada. Mantenla siempre conectada, o revísala en Accounts.
• El broker rechazó un símbolo desconocido: el símbolo resuelto aparece en la entrega; agrega una entrada al mapa de símbolos o un sufijo.
• rejected, límites del plan: se agotaron las órdenes del mes, o varias cuentas en un plan sin órdenes multicuenta.

LímitesCopiar el enlace

• 30 alertas por minuto por hook. Por encima de eso, las alertas se rechazan con 429, y una fila lo registra.
• 25 hooks por workspace.
• Solo órdenes de mercado desde alertas, con stop loss y take profit opcionales. Las órdenes pendientes van por la API.
• Una cuenta por hook en todos los planes; varias cuentas en los planes con órdenes multicuenta, hasta el límite de cuentas por orden del plan.
• Las alertas son órdenes: cuentan para las órdenes mensuales del plan.
• Las entregas se conservan 30 días. Las órdenes se quedan en el historial de órdenes.
• fxapis responde a TradingView de inmediato —TradingView cancela una solicitud de webhook que tarda más de tres segundos (About webhooks, revisado el 30 de septiembre de 2026)— y envía la orden justo después, en el orden en que llegaron las alertas para ese hook.