Um robô pode receber um sinal de entrada em um momento em que você não quer mais operar. Um filtro de horário ajuda a separar a janela em que novas entradas são permitidas do momento em que a posição deve ser encerrada.

Neste tutorial, você vai entender uma regra simples em NTSL que combina horário, compra e saída. O foco é a lógica do exemplo e os cuidados para testá-la, não a criação de uma estratégia completa.

Regras do exemplo

A regra usa uma única janela de operação. Dentro dela, o robô pode enviar uma compra quando o fechamento da barra atual está acima da abertura e não há posição comprada identificada.

Antes do fim da janela, uma posição comprada recebe uma ordem de saída se o fechamento estiver abaixo da abertura. Ao chegar ao horário final, a regra de zeragem passa a ter prioridade sobre a entrada e sobre essa saída por condição de preço.

  • Entrada: permite uma compra dentro da janela quando as condições do exemplo são atendidas.
  • Saída por preço: envia uma ordem para encerrar a compra quando a barra fica abaixo da abertura.
  • Zeragem por horário: solicita o encerramento de uma posição existente a partir do horário final.

Se fechamento e abertura forem iguais, nenhuma das condições de preço é atendida. Isso não impede a zeragem por horário: ela é verificada separadamente e tem prioridade quando o limite é alcançado.

Código comentado

O exemplo a seguir reúne os parâmetros da janela, a condição de compra e as regras de saída.

ntsl
input
  Quantidade(1);
  HoraInicio(100000);   // HHMMSS
  HoraFim(173000);      // HHMMSS

var
  dentroJanela : Boolean;

begin
  // Janela permitida para operar
  dentroJanela := (CurrentTime >= HoraInicio) and (CurrentTime < HoraFim);

  // Zeragem tem prioridade no fim da janela
  if (CurrentTime >= HoraFim) then
    begin
      if HasPosition() then
        ClosePosition();
    end
  else
    begin
      // Entrada simples: compra se fechar acima da abertura
      if dentroJanela and (not IsBought()) and (Close > Open) then
        BuyAtMarket(Quantidade);

      // Saída simples: zera se fechar abaixo da abertura
      if IsBought() and (Close < Open) then
        SellToCoverAtMarket(Quantidade);
    end;
end;
Exemplo educativo em NTSL. Confira a sintaxe no editor de estratégias do Profit antes de usar.

Como o código funciona

Parâmetros da operação

Os parâmetros permitem ajustar os valores usados pela regra sem alterar sua lógica. Quantidade determina a quantidade informada nas ordens de compra e de saída; HoraInicio e HoraFim delimitam a janela.

O horário inicial pertence à janela, enquanto o horário final já aciona a lógica de zeragem. Antes de definir esses valores, pense também em como a estratégia deve se comportar perto dos limites, quando uma ordem pode ainda estar pendente.

Confira o formato da hora

Verifique na documentação da NTSL para a versão do Profit em uso como CurrentTime representa o horário e como preencher os parâmetros. Um formato incompatível pode impedir que as comparações funcionem como esperado.

Cálculo da janela

O exemplo não calcula um indicador técnico. Em vez disso, cria a variável booleana dentroJanela, que registra se o horário atual está no intervalo permitido para a entrada.

CurrentTime fornece o horário usado nas comparações. A variável só fica verdadeira quando o horário já alcançou o início e ainda não chegou ao fim; a condição de compra utiliza esse resultado como filtro.

Esse filtro não cria um sinal de negociação por conta própria. Ele apenas determina se uma compra que também satisfaça as demais condições pode ser enviada naquele momento.

Condição de entrada

A entrada combina três verificações: estar dentro da janela, não identificar uma posição comprada e ter o fechamento da barra acima de sua abertura. O operador and exige que todas sejam verdadeiras ao mesmo tempo.

IsBought() verifica se existe uma posição comprada, e not inverte o resultado dessa verificação. Se as condições forem atendidas, BuyAtMarket(Quantidade) envia uma ordem de compra a mercado com a quantidade definida.

Aqui, not IsBought() apenas evita uma nova compra quando já existe uma posição comprada. Como essa verificação é específica para compra, ela não substitui uma checagem mais ampla de posição, como HasPosition(), quando a intenção for impedir qualquer nova entrada.

Além disso, o fechamento da barra atual pode mudar enquanto ela está em formação. Dependendo da configuração de execução, a condição pode ser avaliada mais de uma vez na mesma barra; não interprete o sinal como necessariamente confirmado no encerramento dela.

Condições de saída

A primeira verificação de saída compara o horário atual ao fim da janela. Se o limite foi alcançado, HasPosition() verifica se há posição e, em caso positivo, ClosePosition() solicita seu encerramento.

Na prática, ClosePosition() é a chamada usada para solicitar o encerramento da posição existente. Como essa verificação fica no primeiro ramo do if, ao atingir HoraFim a estratégia deixa de avaliar, nesse fluxo, tanto a compra quanto a saída por condição de preço.

Antes do horário final, a regra alternativa verifica se há compra e se o fechamento está abaixo da abertura. Nesse caso, SellToCoverAtMarket(Quantidade) envia uma ordem de venda a mercado para cobrir a posição comprada.

A quantidade da ordem de saída precisa ser compatível com a posição efetiva. Se houver diferença entre elas, uma única ordem com a quantidade configurada pode não encerrar toda a posição.

Validação da lógica

Na automação, a comparação de horário só produz efeito quando o código é reavaliado pela estratégia. Por isso, alcançar HoraFim não cria uma ação isolada: a zeragem depende da leitura da condição CurrentTime >= HoraFim na próxima avaliação do bloco.

Sinais muito próximos dos limites da janela seguem a ordem definida no próprio código. Ao alcançar HoraFim, a estratégia entra no ramo da zeragem; antes disso, continuam valendo apenas a compra filtrada pela janela e a saída por condição de preço.

  • Verifique que não há nova compra antes do início da janela.
  • Teste uma condição de entrada dentro do período permitido.
  • Observe a saída por preço antes do horário final.
  • Confira a solicitação de zeragem ao alcançar o limite.
  • Acompanhe ordens pendentes e eventual diferença de quantidade.

Limitações do exemplo

Este exemplo é educativo e trabalha apenas com compras; ele não inclui stop loss, alvo, controle de horário além de uma única janela nem gestão completa de ordens. Também não contempla períodos de pausa ou dias específicos, de modo que qualquer adaptação deve ser testada antes do uso em uma automação.

Pontos principais

  • A janela filtra novas compras desde o início configurado até antes do horário final.
  • A entrada depende também da posição comprada e da relação entre fechamento e abertura.
  • A zeragem por horário tem prioridade quando a estratégia avalia que o limite foi alcançado.
  • Formato de horário, execução das ordens e reavaliação da barra precisam ser testados.
  • O exemplo não substitui uma gestão completa de risco e de ordens.

Atenção ao risco

Operar no mercado financeiro envolve risco de perdas. Este conteúdo é educativo e não constitui recomendação personalizada de investimento.