Payload webhook de TradingView

Objetivo

Esta página documenta el contrato público de WebhookIngress para alertas TradingView. No es el payload de órdenes manuales del dashboard.

Ruta de acceso

• En el área cliente: Mis cuentas > abrir una cuenta de trading > copiar la clave de acceso.
• En TradingView: Alerta > Notificaciones > pegar https://webhook.theconnector.fr/YOUR_ACCESS_KEY en Webhook URL.
• En el campo Message de TradingView, pegar el JSON.

JSON mínimo

{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 20,
  "tp": 40
}

Campos leídos por WebhookIngress

• action es obligatorio. Aliases: side, type, command, msgtype.
• symbol es obligatorio para comandos de trading. Aliases: pair, ticker, instrument, market, asset.
• risk se transmite como riesgo numérico. Para lotaje exacto, use volume, lot, lots o fixedVolume.
• sl y tp son los nombres actuales de stop loss / take profit. Aliases: stoploss, stop_loss, takeprofit, take_profit.
• price solo se usa para órdenes pendientes: buystop, buylimit, sellstop, selllimit.
• ticket, orderId, order_id, positionId o position_id se usan solo si se apunta a una orden o posición conocida.
• account / accountCode y platform son opcionales con la URL de cuenta; solo sirven en rutas compartidas.
• streamId o id puede enviarse para seguimiento. Si falta, el servidor crea un id.
• tag (alias comment) nombra la estrategia a la que pertenece la alerta. En una entrada se escribe en el comentario de la posición en el bróker; en un cierre limita el cierre a las posiciones que llevan ese nombre, así varias estrategias pueden compartir una cuenta y un símbolo. Se pasa a minúsculas y se corta a 12 caracteres, y se respeta a partir del robot 0.0.21 — por debajo, un cierre con nombre se rechaza en lugar de ejecutarse sobre la posición de otra estrategia. Si envías tu propio streamId, este sustituye al generado y el nombre nunca llega al comentario de la posición: omite streamId cuando uses nombres.
• clientRequestedAtUtc, requestedAtUtc o requestedAt pueden enviarse como marca UTC informativa.

Alternativa en una línea

Se recomienda JSON, pero WebhookIngress también acepta texto separado por comas:

buy,EURUSD,risk=1,sl=20,tp=40

Qué no enviar

No se base en ttl_ms, vol_lots, sl_pips o tp_pips: el parser actual de WebhookIngress no lee esos nombres. Use el modo de precio de la cuenta para interpretar sl, tp y price.

Scripts de terceros existentes

No dé por hecho que un mensaje creado para otro conector funciona tal cual. Puede conservar la lógica de estrategia, pero verifique y adapte los campos TradingView anteriores.