NTSL
TMChart usa NTSL, un lenguaje de scripts muy usado por traders brasileños, para tres cosas:
- Indicadores: pintan velas (
PaintBar) y dibujan plots, líneas y textos en el gráfico. - Estrategias: scripts con funciones de orden (
BuyAtMarket,SellShortLimit…). Corren en el Backtest y en las Automatizaciones; en el gráfico las órdenes se ignoran (nada va a MT5). - Optimización: prueba muchas combinaciones de los parámetros de una estrategia.
La lista completa de lo que el editor acepta está en la Referencia de las funciones de NTSL.
Editor de Estrategias
Sección titulada «Editor de Estrategias»Ábralo desde el menú Estrategias → Editor de Estrategias. La pestaña NTSL es la de los scripts NTSL; la pestaña MQL5, la de los programas en MQL5.
Los scripts abiertos quedan en pestañas arriba (haga clic en un script de la lista Mis estrategias para abrirlo; × cierra la pestaña, + crea un script nuevo). Justo debajo está la barra:
- Archivo: Nuevo script, Importar (.tmscript/.tmauto), Eliminar, Exportar, Guardar, Guardar como… (graba una copia con otro nombre; el original queda como estaba guardado) y, en la edición autor, Empaquetar .tmauto.
- Edición: Verificar (compila sin guardar).
- Ejecución: Backtest de la estrategia guardada.
- Haga clic en Nuevo script (o +) y pegue o escriba el código.
- Haga clic en Verificar: los errores aparecen en el Menú de compilación, debajo del código, con línea y columna. Guardar graba el script (el gráfico usa siempre la versión guardada). Una pestaña con cambios sin guardar muestra • en el nombre; cada pestaña guarda sus cambios hasta guardar o cerrar.
- En la lista, cada script muestra el tipo: ind. (indicador), estr. (estrategia) o error (no compila).
- Los indicadores se agregan al gráfico con el botón Indicadores de la barra de herramientas. En Plots elige si aparecen sobre el precio o en panel propio; Solo vela cerrada evita recalcular en cada negocio.
Captura de la app con datos ficticios (demostración).
Estructura de un script
Sección titulada «Estructura de un script»Input Periodo(20);Var m : Real;Inicio m := Media(Periodo, Close); Se Close > m entao PaintBar(clGreen) senao PaintBar(clRed); Plot(m);Fim;- Input (o Parametro): parámetros con valor por defecto, editables en cada gráfico, en el Backtest y en las automatizaciones.
- Const y Var: constantes y variables. Tipos:
Real,Inteiro,BooleanoyString(o en inglés:Integer,Boolean). - Inicio … Fim: el cuerpo, ejecutado una vez por barra, de la más antigua a la más reciente.
- Las palabras clave valen en portugués o en inglés (
Se/If,entao/then,Inicio/Begin…). Mayúsculas y minúsculas no importan.
Series y barras anteriores
Sección titulada «Series y barras anteriores»Close,Open,High,Low,Volumeson series:Close[1]es el cierre de la barra anterior.- Una variable usada con
[n]en algún lugar se vuelve serie y guarda el valor de cada barra. - Un indicador sin barras suficientes devuelve “indefinido”: cualquier comparación con él da falso. La división por cero da 0.
Ejemplo de estrategia
Sección titulada «Ejemplo de estrategia»Input Corta(9); Larga(21);Var c, l : Real;Begin c := MediaExp(Corta, Close); l := MediaExp(Larga, Close); If (c > l) and (c[1] <= l[1]) then BuyAtMarket; If (c < l) and (c[1] >= l[1]) then SellShortAtMarket;End;Un cruce hacia arriba compra; uno hacia abajo vende. Con posición comprada, la venta solo cierra (no invierte); para
invertir, use ReversePosition. Pruébela en el Backtest antes de usarla en una
automatización.
Funciones y procedimientos propios
Sección titulada «Funciones y procedimientos propios»Declárelos antes de Inicio con Funcao Nombre(a : Real) : Real; (o Procedimento; en inglés, Function y
Procedure). Solo ven sus propios parámetros y variables locales: las variables globales se rechazan.
Exportar e importar
Sección titulada «Exportar e importar»En el editor, Exportar guarda el script en un archivo .tmscript:
- Abierto: quien lo importa ve y edita el código.
- Cerrado: código compilado y cifrado. Quien lo importa lo usa, ajusta los parámetros y optimiza, pero no ve el código ni la consola. Se puede indicar el autor y una fecha de validez.
Importar agrega los scripts de un archivo .tmscript o .tmauto.
Importar/Exportar Estrategias (varias a la vez)
Sección titulada «Importar/Exportar Estrategias (varias a la vez)»Menú Estrategias → Importar/Exportar Estrategias:
- Importar: elija el archivo (
.tmscripto.tmauto), pase las estrategias de Disponibles a Seleccionadas (botones>y>>; de vuelta con<y<<) y haga clic en Importar. Las estrategias entran desactivadas. - Exportar: pase las estrategias a Seleccionadas y haga clic en Exportar. Con Exportar código fuente marcado, el archivo sale abierto (quien lo importa ve y edita el código); desmarcado, sale cerrado. Las estrategias cerradas solo salen cerradas.
Diferencias con el manual de NTSL
Sección titulada «Diferencias con el manual de NTSL»- No existe
Caso/Case. - Las funciones que dependen de datos que MT5 no ofrece (agresión, datos por corredora, PTAX…) o de fórmulas no publicadas se rechazan con el motivo — vea la lista al final de la referencia.
- Libro y activo: solo el activo del propio gráfico.