Pular para o conteúdo

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.

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.
  1. Clique em Novo script (ou +) e cole ou escreva o código.
  2. 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.
  3. Na lista, cada script mostra o tipo: ind. (indicador), estr. (estratégia) ou erro (não compila).
  4. 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.

Editor de Estratégias com um script NTSL Print do app com dados fictícios (demonstração).

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, Booleano e String.
  • 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.
  • Close, Open, High, Low, Volume sã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.
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.

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.

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 (.tmscript ou .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.
  • 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.