NTSL
O TMChart usa o NTSL, linguagem de scripts muito usada por traders brasileiros, para três coisas:
- Indicadores: pintam candles (
PaintBar) e desenham plots, linhas e textos no gráfico. - Estratégias: scripts com funções de ordem (
BuyAtMarket,SellShortLimit…). Rodam no Backtest e nas Automações; no gráfico as ordens são ignoradas (nada vai ao MT5). - Otimização: testa várias combinações dos parâmetros de uma estratégia.
A lista completa do que o editor aceita está na Referência das funções do NTSL.
Editor de Estratégias
Seção intitulada “Editor de Estratégias”Abra pelo menu Estratégias → Editor de Estratégias. A aba NTSL é a dos scripts NTSL; a aba MQL5, a dos programas em MQL5.
Os scripts abertos ficam em abas no topo (clique num script da lista Minhas estratégias para abri-lo; × fecha a aba, + cria um script novo). Logo abaixo fica a barra:
- Arquivo: Novo script, Importar (.tmscript/.tmauto), Excluir, Exportar, Salvar, Salvar como… (grava uma cópia com outro nome; o original fica como estava salvo) e, na edição autor, Empacotar .tmauto.
- Edição: Verificar (compila sem salvar).
- Execução: Backtest da estratégia salva.
- Clique em Novo script (ou +) e cole ou escreva o código.
- Clique em Verificar: os erros aparecem no Menu de compilação, abaixo do código, com linha e coluna. Salvar grava o script (o gráfico usa sempre a versão salva). Aba com alteração não salva mostra • no nome; cada aba guarda a sua alteração até salvar ou fechar.
- Na lista, cada script mostra o tipo: ind. (indicador), estr. (estratégia) ou erro (não compila).
- Indicadores entram no gráfico pelo botão Indicadores da barra de ferramentas. Em Plots você escolhe se eles aparecem sobre o preço ou em painel próprio; Só candle fechado evita recalcular a cada negócio.
Print do app com dados fictícios (demonstração).
Estrutura de um script
Seção intitulada “Estrutura de um 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 (ou Parametro): parâmetros com valor padrão, editáveis em cada gráfico, no Backtest e nas automações.
- Const e Var: constantes e variáveis. Tipos:
Real,Inteiro,BooleanoeString. - Inicio … Fim: o corpo, executado uma vez por barra, da mais antiga para a mais recente.
- As palavras-chave valem em português ou inglês (
Se/If,entao/then,Inicio/Begin…). Maiúsculas e minúsculas não fazem diferença.
Séries e barras anteriores
Seção intitulada “Séries e barras anteriores”Close,Open,High,Low,Volumesão séries:Close[1]é o fechamento da barra anterior.- Uma variável usada com
[n]em algum lugar vira série e guarda o valor de cada barra. - Indicador sem barras suficientes devolve “indefinido”: qualquer comparação com ele dá falso. Divisão por zero dá 0.
Exemplo de estratégia
Seção intitulada “Exemplo de estratégia”Input Curta(9); Longa(21);Var c, l : Real;Inicio c := MediaExp(Curta, Close); l := MediaExp(Longa, Close); Se (c > l) e (c[1] <= l[1]) entao BuyAtMarket; Se (c < l) e (c[1] >= l[1]) entao SellShortAtMarket;Fim;Um cruzamento para cima compra; um para baixo vende. Com posição comprada, a venda só zera (não inverte); para
inverter, use ReversePosition. Teste no
Backtest antes de usar numa automação.
Funções e procedimentos próprios
Seção intitulada “Funções e procedimentos próprios”Declare antes do Inicio com Funcao Nome(a : Real) : Real; (ou Procedimento). Eles só enxergam os próprios
parâmetros e variáveis locais: variáveis globais são recusadas.
Exportar e importar
Seção intitulada “Exportar e importar”No editor, Exportar grava o script num arquivo .tmscript:
- Aberto: quem importa vê e edita o código.
- Fechado: código compilado e cifrado. Quem importa usa, ajusta os parâmetros e otimiza, mas não vê o código nem o console. Dá para informar o autor e uma data de validade.
Importar acrescenta os scripts de um arquivo .tmscript ou .tmauto.
Importar/Exportar Estratégias (vários de uma vez)
Seção intitulada “Importar/Exportar Estratégias (vários de uma vez)”Menu Estratégias → Importar/Exportar Estratégias:
- Importar: escolha o arquivo (
.tmscriptou.tmauto), passe as estratégias de Disponíveis para Selecionadas (botões>e>>; de volta com<e<<) e clique em Importar. As estratégias entram desligadas. - Exportar: passe as estratégias para Selecionadas e clique em Exportar. Com Exportar código fonte marcado, o arquivo sai aberto (quem importa vê e edita o código); desmarcado, sai fechado. Estratégias fechadas só saem fechadas.
Diferenças em relação ao manual do NTSL
Seção intitulada “Diferenças em relação ao manual do NTSL”- Não há
Caso/Case. - Funções que dependem de dados que o MT5 não fornece (agressão, dados por corretora, PTAX…) ou de fórmulas não publicadas são recusadas com o motivo — veja a lista no fim da referência.
- Livro e ativo: só o ativo do próprio gráfico.