Defina o que a estratégia deve fazer

Antes de abrir o editor do Profit, descreva a estratégia como uma sequência de decisões observáveis. O robô precisa saber quando pode iniciar uma operação, como deve encerrá-la e em quais circunstâncias não deve agir. No início da programação NTSL, a prioridade é verificar se essas decisões são compreendidas e executadas como previsto, não obter um ganho financeiro.

O que será planejado

Este roteiro trata do planejamento da lógica e dos testes, sem apresentar comandos executáveis ou instruções de menu. Para implementar a estratégia, confirme a sintaxe, as funções e os recursos disponíveis na documentação oficial da Nelogica.

Suponha que o estudo use um nível de preço definido antecipadamente: a ideia é comprar se um candle fechar acima desse nível e sair se outro fechar abaixo dele. Mesmo nesse exemplo simples, ainda é preciso decidir como escolher o nível, o que fazer se o fechamento for exatamente igual a ele e quando permitir uma nova entrada após a saída. Sem essas definições, o comportamento do robô fica ambíguo.

  • Selecione o ativo ou mercado e o intervalo de tempo dos candles para o experimento.
  • Comece com uma regra de entrada simples, que possa ser examinada isoladamente.
  • Especifique como a posição será encerrada e quais limites de exposição serão considerados.
  • Anote os casos em que o robô não poderá iniciar outra operação.
  • Para cada situação de teste, descreva antecipadamente a resposta esperada.

Estruture os componentes do robô

Uma forma de preparar a implementação é dividir o projeto em configurações, cálculos, condições, estado e ações. Essa organização ajuda a raciocinar sobre a estratégia, mas não determina como o programa deve ser escrito. A estrutura exigida pela NTSL deve ser conferida na documentação oficial.

Use parâmetros para representar escolhas ajustáveis do experimento, como o período usado em um cálculo ou uma distância definida para a saída. As variáveis, por sua vez, guardam valores necessários ao processamento, como uma referência calculada ou o resultado de uma verificação. A distinção facilita identificar o que foi escolhido antes do teste e o que é produzido durante a execução.

Considere também a natureza de cada informação. O valor de um preço é numérico; a pergunta “o preço está acima do nível definido?” gera uma resposta lógica. Ao programar, confira os tipos aceitos, a forma de declarar cada elemento e o acesso aos dados de mercado disponíveis.

  • Configurações: valores escolhidos para definir o experimento.
  • Cálculos: resultados obtidos a partir das informações utilizadas pela estratégia.
  • Condições: verificações que liberam ou impedem uma decisão.
  • Estado da operação: informações sobre posição e solicitações que ainda precisam ser acompanhadas.
  • Ações: pedidos de entrada, encerramento ou cancelamento previstos nas regras.

Para cada informação armazenada, defina em que momento ela será inicializada e atualizada. Mesmo sem erro de sintaxe, uma variável usada com valor antigo pode fazer a estratégia tomar uma decisão diferente da planejada.

Diferencie condições de negociação e ordens

O sinal é a identificação de que uma regra foi satisfeita; a ordem é uma solicitação para negociar. Entre uma coisa e outra, ainda é necessário verificar se a ação está autorizada. Além disso, uma ordem enviada pode não ser aceita ou executada. Por isso, cada etapa deve ser acompanhada separadamente.

Em linguagem natural, um fluxo inicial poderia ser: consultar os dados; identificar a posição; procurar uma entrada apenas quando não houver exposição; e, enquanto houver posição, examinar as regras de saída. Antes de solicitar uma ação, também é preciso considerar se há uma solicitação anterior pendente. Essa descrição é um plano lógico, não código NTSL.

Uma ordem de venda não tem sempre o mesmo objetivo: ela pode encerrar uma posição comprada ou iniciar uma posição vendida. Para manter o primeiro experimento mais fácil de investigar, considere trabalhar apenas com compra e encerramento da compra. A abertura de posições vendidas pode ser estudada separadamente.

  1. Sem exposição e sem pedido pendente: procurar a condição definida para uma compra.
  2. Com uma entrada ainda pendente: verificar seu andamento antes de fazer outro pedido.
  3. Com posição comprada: acompanhar as regras que podem determinar o encerramento.
  4. Depois da saída: exigir o critério previsto para um novo sinal, em vez de repetir a entrada só porque a condição anterior permanece verdadeira.

Não cole esse fluxo no editor esperando que ele funcione como programa. Para transformá-lo em NTSL, verifique na documentação os recursos aplicáveis à consulta de posição, ao acompanhamento de ordens e ao envio das ações necessárias.

Implemente a lógica com os recursos documentados

Com as regras escritas, associe cada parte do projeto aos recursos descritos na documentação oficial da Nelogica. Evite presumir que uma função se comporta como outra de nome parecido ou adaptar comandos de linguagens diferentes sem verificar sua validade em NTSL.

  1. Identifique a estrutura necessária para o tipo de estratégia que pretende criar.
  2. Confira como declarar parâmetros e variáveis e quais tipos são apropriados.
  3. Verifique o acesso aos dados usados pela lógica e o momento em que ficam disponíveis.
  4. Examine as funções de negociação, os argumentos exigidos e os efeitos de cada solicitação.
  5. Quando necessário, confirme como obter informações sobre a posição e as ordens pendentes.
  6. Antes do teste, verifique se os recursos escolhidos são compatíveis com o ambiente disponível.

Construa a estratégia gradualmente: comece pelas declarações e pelos cálculos, acrescente as condições e deixe as ações de negociação para depois. Execute as verificações disponíveis a cada alteração. Lembre-se: passar pela verificação de sintaxe não comprova a correção da lógica.

Configure o teste em simulação e observe os eventos

Em cada sessão, confirme que a execução está direcionada à simulação, e não a uma conta real. Revise também o ativo, a periodicidade, a quantidade e as regras habilitadas. Uma configuração que estava correta anteriormente precisa ser conferida novamente antes de cada teste.

Use primeiro um cenário fácil de acompanhar. Observe a condição que gerou o sinal, a solicitação feita em seguida e a mudança no estado da operação. Se algo ocorrer de forma diferente do planejado, interrompa a execução e investigue a causa antes de mudar parâmetros em busca de um resultado melhor.

  • A compra ocorreu somente quando a regra de entrada foi satisfeita?
  • A avaliação aconteceu no instante escolhido, como no fechamento do candle?
  • Uma condição que permaneceu verdadeira gerou pedidos repetidos?
  • A ação de saída encerrou a posição que deveria ser encerrada?
  • Uma solicitação pendente foi acompanhada de acordo com o projeto?
  • Foi possível reconhecer e interromper uma execução inesperada?

Documente cada teste com o cenário, a resposta esperada, o que foi observado e a alteração feita. A simulação é útil para examinar a lógica, mas pode não refletir integralmente uma execução real: liquidez, atrasos e diferenças entre o preço esperado e o executado são exemplos de fatores relevantes.

Valide a versão simples antes de acrescentar regras

Um primeiro marco útil é conseguir explicar por que o robô agiu ou permaneceu inativo em cada situação testada. Um resultado positivo em um episódio isolado não comprova que a implementação está correta nem garante comportamento semelhante em outras condições.

Modifique um componente por vez e repita os testes afetados pela mudança. Inclua cenários em que a resposta correta seja não abrir operação. Somente depois de entender o funcionamento da versão inicial faz sentido acrescentar novas condições: criar um robô envolve especificar, programar e verificar decisões, não apenas identificar sinais no gráfico.

Riscos da negociação automatizada

Negociar no mercado financeiro pode gerar perdas. Erros de lógica, configuração ou execução também podem afetar robôs, e resultados simulados não garantem resultados futuros. 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.