PineLink.io

Sintaxis de señales

Todos los parámetros aceptados en el mensaje de TradingView, con ejemplos. La referencia completa.

Esta es la referencia completa del lenguaje que entiende PineLink en los mensajes de TradingView. Para ejemplos y tutoriales empieza por Configurar alertas en TradingView.

Forma general

<accion> <simbolo> [parametros opcionales]

Donde:

  • <accion> es obligatoria: Buy, Sell, Close o Close partial=N.
  • <simbolo> es obligatorio para Buy, Sell y Close. (Para close_all no aplica — pero close_all es interno, no se manda desde TradingView.)
  • Los parámetros van separados por espacios, en formato clave=valor, en cualquier orden.

Acciones disponibles

| Acción | Sintaxis | Qué hace | |--------|----------|----------| | Compra a mercado | Buy EURUSD ... | Abre una posición LONG inmediatamente | | Venta a mercado | Sell EURUSD ... | Abre una posición SHORT inmediatamente | | Compra pendiente | Buy EURUSD ord=limit px=1.08 ... | Coloca una orden pendiente (limit o stop) | | Venta pendiente | Sell EURUSD ord=stop px=1.07 ... | Idem en SHORT | | Cerrar todo del símbolo | Close EURUSD | Cierra TODAS las posiciones abiertas del EA en EURUSD | | Cerrar parcial | Close EURUSD partial=50 | Cierra el 50% del volumen abierto en EURUSD | | Cerrar un ticket específico | Close EURUSD ticket=123456 | Cierra solo esa posición concreta |

Las acciones son case-insensitive: Buy, BUY, buy son lo mismo.

Parámetros del trade

sl= — Stop Loss

| Sintaxis | Modo | Ejemplo | Significado | |----------|------|---------|-------------| | sl=15 | Pips | Buy EURUSD sl=15 | SL a 15 pips del precio de entrada | | sl=15p | Pips explícito | Buy EURUSD sl=15p | Igual que arriba (sufijo p redundante) | | sl=1.0820 | Precio | Buy EURUSD sl=1.0820 | SL en el precio absoluto 1.0820 | | sl=1.5% | % del precio | Sell XAUUSD sl=1.5% | SL al 1.5% del precio de entrada |

Cómo distingue PineLink "pips" vs "precio":

  • Si lleva % → percent.
  • Si lleva p al final → pips.
  • Sin sufijo → usa el default que tienes en /ea-config → SL/TP modes (por defecto pips).

tp= — Take Profit

Mismas reglas que sl=. Ejemplos:

| Sintaxis | Significado | |----------|-------------| | tp=30 | TP a 30 pips | | tp=1.0900 | TP en el precio 1.0900 | | tp=3% | TP al 3% del precio de entrada |

risk= — Tamaño de la posición

Define cuánto opera la señal. Mira Modos de riesgo para detalle.

| Sintaxis | Modo | Ejemplo | |----------|------|---------| | risk=0.05 | fixed_lot | 0.05 lotes | | risk=$50 o risk=50$ | fixed_dollar | Pierdes $50 si SL | | risk=0.5% | percent_balance | 0.5% del balance si SL | | risk=20%m | percent_margin | Usa 20% del margen libre |

Si risk= no está presente: PineLink usa el default de tu /ea-config → Riesgo.

ord= — Tipo de orden

| Sintaxis | Significado | |----------|-------------| | ord=market (default) | Orden a mercado, ejecución inmediata | | ord=limit | Orden pendiente LIMIT (espera precio mejor) | | ord=stop | Orden pendiente STOP (espera ruptura) |

px= — Precio para órdenes pendientes

Solo aplica con ord=limit o ord=stop. Es el precio al que debe llegar el mercado para que la orden se active.

Buy EURUSD ord=limit px=1.0800 sl=15 tp=30 risk=0.5%

Buy LIMIT a 1.0800, con SL 15 pips por debajo y TP 30 pips por arriba desde 1.0800 (no desde el precio actual).

partial= — Cierre parcial

Solo aplica con acción Close.

Close EURUSD partial=50

Cierra el 50% del volumen total abierto del EA en EURUSD. Resto: sigue abierto.

ticket= — Cerrar una posición concreta

Solo aplica con acción Close. Útil cuando tienes varias posiciones abiertas y quieres cerrar solo una.

Close EURUSD ticket=123456789

tag= — Etiqueta para auditoría

Texto libre (máx 40 chars) que se guarda en la operación para que la veas después en /trades. Útil para identificar qué estrategia abrió qué.

Buy EURUSD sl=15 tp=30 risk=0.5% tag=cruce-medias-h1

# comentario — Comentario libre

Todo lo que sigue a # se guarda como comentario (máx 200 chars). También aparece en /trades.

Buy EURUSD sl=15 tp=30 risk=0.5% # rotura del rango asiatico

Combinaciones completas — ejemplos

Estilo "scalping forex"

Buy EURUSD sl=10 tp=15 risk=0.3%

Estilo "swing con TP largo"

Buy XAUUSD sl=2% tp=6% risk=0.5%

Estilo "limit en breakout retest"

Buy EURUSD ord=limit px=1.0800 sl=1.0780 tp=1.0850 risk=$25 tag=retest-h4

Estilo "cierre parcial de TP1"

Estrategia: dos TPs. La alerta de TP1 cierra el 50% y mueve SL a break-even (esto último lo hace tu Pine Script con otra alerta).

Close EURUSD partial=50 # tp1 alcanzado

Estilo "cerrar todo en condición opuesta"

Close EURUSD # rsi sobre-extendido

Variables dinámicas de TradingView

Estas variables las reemplaza TradingView, no PineLink:

| Variable | Reemplazo en runtime | |----------|----------------------| | {{ticker}} | Símbolo del gráfico (ej. EURUSD) | | {{close}} | Precio de cierre actual | | {{open}}, {{high}}, {{low}} | Precios de la vela | | {{plot_0}}, {{plot_1}}, ... | Valores de tus plot() en Pine Script | | {{strategy.order.action}} | buy o sell (si la alerta viene de strategy()) |

Ejemplo combinado (una sola alerta para cualquier par y cualquier dirección):

{{strategy.order.action}} {{ticker}} sl=20 tp=40 risk=0.5%

Errores de parseo

Si tu mensaje no respeta la sintaxis, PineLink lo guarda como blocked con razón parse_error. El mensaje específico te dice qué falló:

| Mensaje | Causa probable | |---------|----------------| | unknown action | La primera palabra no es Buy/Sell/Close/... | | missing symbol | Falta el símbolo después de la acción | | risk requires sl | Usas risk=$X o risk=X% sin sl= definido | | invalid order_type | ord= con valor distinto de market/limit/stop | | px requires ord=limit\|stop | Pusiste px= sin orden pendiente | | partial only with close | partial= solo se usa con Close | | ambiguous risk syntax | El sufijo del risk= no se entiende | | tag too long | Tag de más de 40 chars | | comment too long | Comentario (después de #) de más de 200 chars | | symbol too long | Símbolo de más de 20 chars |

Mira el mensaje exacto en /signals y corrige la alerta en TradingView.

Próximos pasos