Mensaje de alerta de TradingView: el formato, ejemplo por ejemplo
El mensaje es el único texto que envía su alerta. Para convertirse en una orden en MT4, MT5 o cTrader, sigue un formato sencillo: un objeto JSON o una sola línea de texto. Aquí tiene cada campo, cada comando y ejemplos listos para copiar, todos comprobados en el probador de webhook.
El mensaje de la alerta
{
"action": "buy",
"symbol": "EURUSD",
"volume": 0.10,
"sl": 1.0820,
"tp": 1.0910
}Adónde va el mensaje
En la ventana de alerta de TradingView, el campo Message contiene el texto enviado en cada disparo, y el campo Webhook URL, la dirección a la que se envía. Esa dirección es la de su cuenta de TheConnector: ya lleva la clave de acceso, así que el mensaje solo describe la orden.
- Una alerta envía un mensaje y, por tanto, un comando
- La clave de acceso se queda en la dirección del webhook, nunca en el mensaje
- TradingView sustituye las variables como {{ticker}} antes del envío
El mensaje mínimo
Dos campos bastan para un mensaje válido: el comando y el símbolo. La orden toma entonces su tamaño de los ajustes de riesgo de la cuenta, y un cálculo por riesgo necesita un stop: en la práctica, añada al menos un stop-loss, o un número fijo de lotes.
{"action":"buy","symbol":"EURUSD"}
buy,EURUSD- action: qué hacer, aquí comprar
- symbol: el ticker de TradingView, asociado al símbolo de su bróker
- La forma de texto en una línea lleva exactamente la misma información
Los campos del mensaje
Ocho campos cubren casi todas las necesidades. Sus nombres se escriben en minúsculas y sus valores son números, salvo el comando, el símbolo y el tag. Un campo que TheConnector no conoce se ignora sin ningún aviso: un nombre mal escrito pasa desapercibido, de ahí la utilidad del probador antes de operar en real.
actionEl comando: comprar, vender, cerrar, cancelar, modificarbuysymbolEl instrumento, tal como lo nombra TradingViewEURUSDriskRiesgo de la orden, leído según la fuente de riesgo de la cuenta1volumeUn número fijo de lotes, que tiene prioridad sobre el riesgo0.10slStop-loss, en el modo de precio de la cuenta20tpTake-profit, en el modo de precio de la cuenta40pricePrecio de entrada de una orden pendiente1.0850tagNombre de la estrategia, para distinguir varias en un mismo símbolotrend- Alias aceptados: lot o lots para volume, stoploss para sl, takeprofit para tp
- Sin campo account: la dirección del webhook ya designa la cuenta
- Otros comandos y ajustes por alerta figuran en la referencia de sintaxis
Los comandos
El campo action lleva uno de los comandos siguientes. Cada uno acepta también una forma con guion bajo, como close_long, y se aceptan long y short en lugar de buy y sell.
buy / sellAbre una posición a mercado, de compra o de ventabuy,EURUSD,risk=1,sl=20buylimit / selllimitOrden pendiente por debajo del precio (compra) o por encima (venta)buylimit,EURUSD,price=1.0850,volume=0.1buystop / sellstopOrden pendiente por encima del precio (compra) o por debajo (venta)sellstop,GBPJPY,price=198.250,risk=1,sl=198.800closelong / closeshortCierra la posición de compra o de venta del símbolocloselong,EURUSDcloselongshortCierra los dos sentidos en el símbolocloselongshort,EURUSDcancellong / cancelshortCancela las órdenes pendientes de compra o de ventacancelshort,GBPJPYnewsltplong / newsltpshortMueve el stop-loss y el take-profit de la posición abiertanewsltplong,EURUSD,sl=15,tp=60- Una orden pendiente necesita su precio de entrada
- Un cierre o una modificación indica el símbolo, como una entrada
- breakevenlong y breakevenshort son alias de newsltplong y newsltpshort
Comprar o vender a mercado, con stop y objetivo
El mensaje más habitual: una entrada a mercado dimensionada según el riesgo, con su stop-loss y su take-profit. Con la fuente de riesgo en Porcentaje de TradingView y el modo de precio en pips, este ejemplo arriesga el 1 % del saldo, con un stop a 20 pips y un objetivo a 40 pips.
{"action":"buy","symbol":"EURUSD","risk":1,"sl":20,"tp":40}- Para una venta, sustituya buy por sell
- El riesgo es la pérdida si se alcanza el stop, no el tamaño de la posición
- Para imponer un tamaño, envíe volume en lugar de risk
Colocar una orden pendiente
Una compra limitada espera a que el precio baje hasta su entrada; una compra stop, a que suba hasta ella. Este ejemplo supone que el modo de precio de la cuenta está en precio absoluto: la entrada, el stop y el objetivo son precios de mercado.
{"action":"buylimit","symbol":"EURUSD","price":1.0850,"volume":0.10,"sl":1.0820,"tp":1.0910}- Aquí el tamaño es fijo: 0,10 lotes
- En modo pips o porcentaje, los mismos campos se leen como distancias
- cancellong retira las órdenes pendientes de compra si el escenario ya no es válido
Cerrar una posición o mover su stop
Tres mensajes, uno por alerta: cerrar la posición de compra, cerrar los dos sentidos y, después, mover el stop-loss y el objetivo de la posición de compra abierta. Como una entrada, cada uno indica su símbolo.
{"action":"closelong","symbol":"EURUSD"}
{"action":"closelongshort","symbol":"EURUSD"}
{"action":"newsltplong","symbol":"EURUSD","sl":15,"tp":60}- Un cierre sin tag toma la primera posición en el sentido pedido
- Con varias estrategias en el mismo símbolo, nómbrelas con tag
- Copie una línea por alerta, nunca el bloque entero
Dos estrategias en el mismo símbolo
Sin nombre, un cierre toma la primera posición que encuentra, quizá la de la otra estrategia. El campo tag da nombre a la estrategia: en la entrada, el robot escribe ese nombre en el comentario de la posición en el bróker, y un cierre con nombre solo afecta a las posiciones que lo llevan.
{"action":"buy","symbol":"USDJPY","risk":1,"sl":20,"tag":"trend"}
{"action":"closelong","symbol":"USDJPY","tag":"trend"}- El mismo tag en todas las alertas de la estrategia, tanto entradas como salidas
- Los tags se pasan a minúsculas y se cortan a 12 caracteres: manténgalos cortos y distintos
- Solo letras, dígitos, - y _
Poner variables de TradingView en el mensaje
Un solo mensaje puede servir en todos los gráficos: con {{ticker}}, el símbolo sigue al gráfico en el que se crea la alerta. TradingView sustituye la variable antes del envío, así que TheConnector recibe el símbolo real.
{"action":"buy","symbol":"{{ticker}}","risk":1,"sl":20,"tp":40}- Las variables de texto van entre comillas ("{{ticker}}"), los números como {{close}} no
- Alertas de estrategia: {{strategy.order.action}} dice «sell» para salir de una compra; prefiera alert_message
- La lista completa de variables está en la guía de alertas de TradingView
Las unidades del stop, del objetivo y del precio
Los números de sl, tp y price se leen según el modo de precio elegido en los ajustes de la cuenta. Precio absoluto: un precio de mercado, como 1.0750. Pips: una distancia desde la entrada, como 20. Porcentaje: una distancia en porcentaje del precio de entrada, como 0.5.
- El modo de precio debe coincidir con lo que envían sus alertas
- Los pips son adecuados para el forex; en índices y metales, prefiera el precio o el porcentaje
- Escriba los decimales con punto: en la forma de una línea, la coma separa los campos
- Variante: sl_pips, sl_price o sl_pct (y tp_pips, tp_price, tp_pct) fijan la unidad en la propia alerta
Los errores por los que se rechaza un mensaje
La mayoría de los rechazos se deben a un puñado de causas, y el historial de alertas indica cada una de ellas. La primera sorprende: un campo account copiado de un ejemplo antiguo hace que se rechace toda la alerta, incluso con una clave válida.
- Un campo account que no coincide exactamente con la cuenta: se rechaza como si la clave de acceso fuera incorrecta
- JSON mal formado: una comilla olvidada o una coma de más
- Un comando desconocido o ausente, o un símbolo que falta
- Un número acompañado de texto o de una unidad, como 20pips o 1%
Comprobar un mensaje antes de enviarlo
El probador de webhook gratuito lee su mensaje con el mismo analizador que la pasarela de producción y muestra lo que entiende: comando, símbolo, tamaño, stop, objetivo, tag. No se envía nada a ninguna cuenta. El generador de alertas de la página de inicio compone el mensaje por usted.
- Pegue el mensaje exactamente como estará en TradingView
- Sustituya las variables por valores reales antes de la prueba
- Después, envíe una primera alerta a una cuenta demo
Guías relacionadas
FAQ
¿Hay que poner la clave de acceso en el mensaje?
No. Forma parte de la dirección del webhook copiada desde su panel, que identifica la cuenta. El mensaje solo describe la orden.
JSON o una línea de texto: ¿cuál elegir?
Se aceptan ambos y llevan los mismos campos. El JSON da nombre a cada valor, lo que lo hace más fácil de releer; la forma en una línea, como buy,EURUSD,risk=1,sl=20,tp=40, es más corta de escribir.
¿Cómo cerrar una posición desde una alerta?
Envíe closelong para cerrar la posición de compra o closeshort para la de venta, con el símbolo: {"action":"closelong","symbol":"EURUSD"}. Con varias estrategias en el símbolo, añada el mismo tag que en la entrada.
¿Por qué se rechaza mi alerta aunque la clave sea válida?
La mayoría de las veces, por un campo account copiado de un ejemplo antiguo: si está presente, debe coincidir exactamente con la cuenta; si no, la alerta se rechaza como si la clave fuera incorrecta. Elimínelo: basta con la dirección del webhook.
¿Se puede enviar el precio de cierre de la vela?
Sí, con la variable {{close}}, sin comillas. Sirve como precio de entrada de una orden pendiente, cuando el modo de precio de la cuenta está en precio absoluto.
¿Qué ocurre si el mensaje contiene un campo que TheConnector no conoce?
Se ignora, sin error. La orden sale sin él: por tanto, un nombre mal escrito cambia la orden sin avisar. Compruebe el mensaje en el probador de webhook.