Aprender a linguagem NTSL envolve mais do que memorizar nomes de funções. Ao examinar uma estratégia no Profit, procure entender a finalidade de cada trecho: alguns recebem ajustes, outros produzem informações e outros usam essas informações para tomar decisões ou solicitar operações.

Essa leitura por responsabilidades evita equívocos, como imaginar que um cálculo já determina uma negociação. A seguir, vamos acompanhar o percurso dos dados e os cuidados necessários para conferir se a implementação corresponde à ideia planejada.

Da configuração à ação

Uma forma de interpretar uma estratégia é acompanhar o que entra, como os dados são tratados e o que acontece depois de uma decisão. Essa divisão ajuda no raciocínio, mas não substitui as regras de estrutura e sintaxe da NTSL descritas na documentação oficial da Nelogica.

  • Ajustar: estabelecer valores usados pela regra, como o número de períodos de um cálculo.
  • Guardar: associar resultados a variáveis para que possam ser consultados durante o processamento.
  • Verificar: avaliar relações entre os dados e identificar se os requisitos de uma decisão foram cumpridos.
  • Agir: usar a lógica para uma finalidade específica, como exibir um valor ou solicitar uma ordem.

Ao analisar cada parte, pergunte o que ela recebe e que efeito produz. O cálculo de uma medida e uma solicitação relacionada a ordens podem trabalhar juntos, mas não desempenham a mesma função.

O que muda entre parâmetros e variáveis

Um parâmetro é uma configuração consultada pela estratégia. Por exemplo, em vez de repetir o período de uma média em diferentes pontos, a regra pode usar um parâmetro identificado para esse ajuste. Sua declaração deve seguir os atributos e a sintaxe exigidos pela linguagem.

Já uma variável é usada para guardar um valor durante o processamento. Ela pode receber o resultado de um cálculo ou de uma condição, por exemplo. É preciso declará-la com um tipo adequado e garantir que tenha recebido o valor necessário antes de ser consultada.

  • Ajuste de cálculo: um parâmetro pode determinar quantos períodos entram na formação de um indicador.
  • Valor numérico: uma variável pode guardar uma medida para uso posterior em uma comparação.
  • Valor lógico: uma variável pode registrar se determinada verificação é verdadeira ou falsa.

Outra distinção essencial é a de atribuição e comparação. Atribuir é colocar um valor em uma variável; comparar é verificar uma relação entre valores. Como cada operação tem sua própria sintaxe, confira os operadores no manual antes de escrever a regra.

Como as condições formam uma decisão

Uma condição transforma dados em uma verificação que a estratégia pode usar para decidir. Imagine uma regra hipotética que procure o preço abaixo de uma referência e só permita uma entrada quando não houver posição aberta. A primeira verificação define o sinal; a segunda limita a ação de acordo com a situação operacional.

  • E: a combinação só é verdadeira quando todas as condições envolvidas são verdadeiras.
  • OU: basta que uma das condições combinadas seja verdadeira.
  • NÃO: transforma uma condição verdadeira em falsa e uma falsa em verdadeira.

A escolha do operador muda a decisão. Se o exemplo usasse OU entre o sinal e a ausência de posição, a regra poderia autorizar a ação somente porque não há posição aberta, sem que o preço estivesse na condição desejada.

Um exercício útil é descrever, antes do código, tanto o cenário que permite a ação quanto os que devem impedi-la. Na implementação, confira as estruturas condicionais e o agrupamento das expressões para que a linguagem avalie a combinação pretendida.

Agora que você distingue configuração, cálculo, decisão e execução, o próximo passo é praticar a implementação dessas etapas em NTSL e testar o comportamento das suas regras.

O que um indicador entrega à estratégia

Um indicador aplica um cálculo a dados e produz uma medida para análise. Em uma estratégia, essa medida pode ser guardada, exibida ou comparada com outro valor. A função que calcula o indicador não define sozinha o que fazer com o resultado.

Considere uma média desenhada no gráfico: sua presença facilita a observação, mas não estabelece uma entrada. Para que exista uma decisão, é necessário formular uma condição; para que haja uma solicitação operacional, é necessário tratar também a execução.

  • Identifique as informações e os ajustes esperados pela função.
  • Entenda o valor retornado e o significado que ele terá na regra.
  • Confira a qual momento ou período cada valor se refere.
  • Investigue o comportamento do cálculo quando o histórico disponível for insuficiente.

A referência temporal pode mudar o resultado de uma comparação: um dado anterior e um dado atual representam momentos distintos. Ao simular o passado, a lógica deve se limitar às informações que estariam disponíveis no instante da decisão, sem utilizar dados futuros.

Execução e estado operacional

Os comandos de execução conectam uma decisão a solicitações de negociação. Antes de escolhê-los, é preciso definir se a intenção é abrir ou reduzir uma posição, encerrá-la, planejar uma proteção ou lidar com ordens que ainda aguardam atendimento.

  • Estado: consultar o que for relevante sobre posições e ordens existentes.
  • Abertura: solicitar uma entrada quando a lógica e os limites de exposição permitirem.
  • Encerramento: solicitar a redução ou a saída de uma posição já existente.
  • Ordens pendentes: planejar seu tratamento de acordo com os recursos documentados no ambiente.

Suponha uma estratégia planejada para manter apenas uma posição por vez. A ausência de posição aberta não garante, por si só, que outra entrada possa ser solicitada: uma ordem anterior ainda pode estar pendente. Esse estado também deve ser considerado no planejamento.

Há ainda uma diferença entre solicitar uma ordem e confirmar que ela foi executada. A solicitação pode ser rejeitada ou continuar pendente, e seu atendimento depende das condições de negociação. Por isso, a lógica precisa considerar o acompanhamento desses estados.

O planejamento de proteção também merece avaliação própria. Uma ordem de saída está sujeita às suas características e às condições de mercado e não elimina a possibilidade de perdas. Um sinal coerente, isoladamente, não garante que a operação ocorrerá como esperado.

Da documentação aos testes

Ao implementar uma ideia em NTSL, recorra ao manual oficial da Nelogica e à documentação aplicável ao ambiente de uso. Examine a assinatura de cada função: quais argumentos ela exige, em que ordem devem ser informados e qual resultado retorna, quando houver.

  1. Confirme na documentação para que serve cada instrução e em qual contexto pode ser usada.
  2. Revise a escrita, os tipos, a sequência dos argumentos e as limitações informadas.
  3. Comece com um teste reduzido, concentrado em uma parte da lógica de cada vez.
  4. Descreva situações esperadas em palavras e confronte-as com o comportamento observado.
  5. Inclua verificações com posição aberta, ordem pendente e repetição de sinal antes de ampliar o teste.

Passar pela compilação não é o mesmo que validar a estratégia. O código pode atender às regras formais e ainda assim expressar uma condição diferente da pretendida ou solicitar uma ordem em um momento inadequado.

Para investigar essas diferenças, acompanhe valores intermediários e registros de execução disponíveis. Testes históricos e simulações são ferramentas de análise, mas não reproduzem todas as condições reais de operação e não garantem desempenho futuro.

Síntese para a leitura de estratégias

  • Classifique os trechos pela responsabilidade que cumprem: ajuste, armazenamento, verificação ou ação.
  • Entenda o papel de parâmetros e variáveis e não confunda atribuir com comparar.
  • Lembre que um indicador fornece uma medida; a decisão e a ordem exigem lógica própria.
  • Inclua o estado das posições e das ordens pendentes no desenho operacional.
  • Use a documentação oficial e teste a intenção da regra, além de verificar se o código compila.

Riscos de operar com estratégias automatizadas

A negociação no mercado financeiro pode gerar perdas, inclusive quando há automação. Erros na lógica, problemas de execução e falhas de infraestrutura são fatores que podem afetar uma operação. Este material tem finalidade educativa e não é uma recomendação personalizada de investimento.

Aviso de risco

Operar no mercado financeiro envolve risco de perdas. Este conteúdo é educativo e não constitui recomendação de investimento. Teste as regras em ambiente de simulação antes de considerar seu uso.