Um indicador, por si só, não diz a um robô exatamente quando agir. Para programar uma estratégia, é necessário transformar sua leitura em condições objetivas, definir que ordem será enviada e considerar o estado da posição.

A seguir, vamos examinar um exemplo em NTSL que utiliza o Índice de Força Relativa, ou IFR, também chamado de Relative Strength Index (RSI). A proposta é estudar a lógica e observá-la em simulador ou na reprodução histórica do pregão, conhecida como replay. O código não é uma estratégia pronta para operar com dinheiro real.

Qual é a ideia por trás das regras?

O IFR mede a força dos movimentos recentes de preço em uma escala de 0 a 100. Leituras nas regiões chamadas de sobrevenda e sobrecompra ajudam a organizar a análise, mas não obrigam o preço a reverter.

Neste exemplo, uma leitura baixa não basta para disparar a compra. A regra procura a passagem do IFR para cima do limite de sobrevenda: na barra anterior, o indicador estava nesse limite ou abaixo dele; na leitura atual, está acima.

Para a saída, a estratégia verifica se há posição comprada e se o IFR atingiu o nível de sobrecompra. Mesmo com regras definidas, sinais podem falhar, sobretudo em movimentos fortes, e o código não inclui proteção de risco nem cálculo de custos.

  • Sinal de entrada: observar a passagem do IFR para cima do limite de sobrevenda.
  • Checagem de posição: antes da compra, confirmar se a estratégia ainda não está comprada.
  • Condição de saída: enviar uma ordem de venda para cobrir a compra quando o IFR atingir a sobrecompra.
  • Inspeção no gráfico: usar cores nas barras e a curva do indicador para acompanhar as leituras.
ntsl
input
  PeriodoIFR(14);
  NivelSobrevenda(30);
  NivelSobrecompra(70);
  Lote(1);

var
  ifrAtual : Float;
  ifrAnterior : Float;

begin
  { Calcula o IFR atual e o IFR do candle anterior }
  ifrAtual := IFR(PeriodoIFR);
  ifrAnterior := IFR(PeriodoIFR)[1];

  { Compra se o IFR sai da zona de sobrevenda }
  if (ifrAnterior <= NivelSobrevenda) and (ifrAtual > NivelSobrevenda) then
    if (not IsBought()) then
      BuyAtMarket(Lote);

  { Vende se o IFR entra na zona de sobrecompra }
  if (ifrAtual >= NivelSobrecompra) and IsBought() then
    SellToCoverAtMarket(Lote);

  { Cores para inspeção visual }
  if (ifrAtual >= NivelSobrecompra) then
    PaintBar(clRed)
  else if (ifrAtual <= NivelSobrevenda) then
    PaintBar(clGreen);

  Plot(ifrAtual);
end;
Exemplo educativo em NTSL para inspeção em replay ou simulador.

Exemplo completo de estratégia em NTSL

A implementação começa com IFR de período 14, limites de 30 e 70 e quantidade de ordem igual a 1. Esses parâmetros servem para demonstrar a lógica; não são uma configuração recomendada.

Este é o código integral para estudo:

```ntsl input PeriodoIFR(14); NivelSobrevenda(30); NivelSobrecompra(70); Lote(1);

var ifrAtual : Float; ifrAnterior : Float;

begin { Calcula o IFR atual e o IFR do candle anterior } ifrAtual := IFR(PeriodoIFR); ifrAnterior := IFR(PeriodoIFR)[1];

{ Compra se o IFR sai da zona de sobrevenda } if (ifrAnterior <= NivelSobrevenda) and (ifrAtual > NivelSobrevenda) then if (not IsBought()) then BuyAtMarket(Lote);

{ Vende se o IFR entra na zona de sobrecompra } if (ifrAtual >= NivelSobrecompra) and IsBought() then SellToCoverAtMarket(Lote);

{ Cores para inspeção visual } if (ifrAtual >= NivelSobrecompra) then PaintBar(clRed) else if (ifrAtual <= NivelSobrevenda) then PaintBar(clGreen);

Plot(ifrAtual); end; ```

Os parâmetros determinam o período do indicador, os dois limites de comparação e a quantidade usada nas ordens. As variáveis guardam as leituras atual e anterior do IFR.

Para visualizar a regra de entrada, imagine que o IFR anterior seja 28 e o atual, 31. Com o limite em 30, as duas comparações do sinal de compra seriam atendidas.

Mesmo nesse cenário hipotético, a compra só é solicitada se IsBought() não identificar uma posição comprada. O sinal, portanto, não deve ser confundido com a execução da ordem.

Se o IFR atual alcançar 70 e houver posição comprada reconhecida, a regra solicita uma venda a mercado para cobrir a quantidade indicada por Lote.

As cores representam a região em que o IFR se encontra: vermelho para sobrecompra e verde para sobrevenda. Elas auxiliam a leitura, mas não substituem a consulta às ordens.

Por fim, Plot(ifrAtual) desenha a leitura do indicador. A curva ajuda a comparar os valores observados com as condições programadas.

Um exercício de programação

Mantenha o exemplo em replay ou simulador e confirme a sintaxe no editor e na documentação da instalação utilizada. A compilação mostra apenas que o código passou por uma verificação técnica; ela não demonstra desempenho nem elimina riscos operacionais.

Leitura detalhada da implementação

Ajustes e armazenamento

O bloco input concentra as configurações usadas pela estratégia. PeriodoIFR define o período passado ao indicador; os níveis de sobrevenda e sobrecompra estabelecem as referências; e Lote informa a quantidade nas chamadas de ordem.

Em var, as leituras ifrAtual e ifrAnterior são declaradas como Float, tipo que admite valores decimais. Mantê-las separadas permite verificar não apenas onde o IFR está, mas também sua relação com a leitura da barra anterior.

Qual leitura é comparada?

A chamada IFR(PeriodoIFR) fornece a leitura atual. Com [1], a expressão acessa o valor da barra anterior. Em cada caso, := atribui o resultado à variável correspondente.

A barra anterior não é necessariamente o último instante de negociação. Por isso, vale conferir em que momento a estratégia é avaliada: durante a formação de uma barra, o IFR atual pode mudar antes do fechamento.

Quando a compra é solicitada

A expressão com and exige que as duas comparações sejam verdadeiras: IFR anterior menor ou igual ao limite de sobrevenda e IFR atual maior que esse limite. Por exemplo, passar de 29 para 30 não satisfaz a segunda comparação quando o nível é 30.

Antes de chamar BuyAtMarket(Lote), a regra verifica not IsBought(). Isso evita solicitar outra compra quando a estratégia reconhece que já está comprada, mas não constitui uma checagem completa de ordens pendentes ou de todos os estados operacionais.

Quando a venda é solicitada

Para sair, o código combina duas verificações: IFR atual maior ou igual ao nível de sobrecompra e posição comprada reconhecida por IsBought(). Em seguida, chama SellToCoverAtMarket(Lote) para solicitar a cobertura da quantidade definida em Lote.

A comparação com a barra anterior aparece na entrada, não na saída. Assim, a condição de venda verifica o nível atual, sem exigir que o IFR tenha cruzado o limite a partir de baixo, apesar da descrição resumida no comentário do código.

O que observar nas cores e na curva

PaintBar colore a barra de vermelho quando o IFR está na região de sobrecompra e de verde quando está na de sobrevenda. Já Plot apresenta a leitura do IFR para acompanhamento gráfico.

A cor verde indica a região, não uma compra: o sinal de entrada depende da posterior saída da sobrevenda. O vermelho também não confirma uma venda; é preciso haver posição comprada e conferir nos registros se a ordem foi executada.

Depois de entender as condições do IFR, aprofunde a programação em NTSL para estruturar novas regras e verificar seu comportamento em simulador.

Roteiro para experimentar no simulador

Antes de olhar para qualquer resultado financeiro, verifique se o comportamento observado corresponde às regras. Cada sinal, envio de ordem e mudança de posição deve poder ser relacionado a uma condição do código.

  1. Coloque o exemplo no editor de estratégias de execução e verifique se ele compila.
  2. Escolha replay ou simulação e anote o ativo, o período gráfico e os parâmetros empregados.
  3. Revise quando a estratégia é avaliada e como está configurado o envio de ordens.
  4. Encontre passagens para fora da sobrevenda e confronte as leituras com as compras registradas.
  5. Examine as condições de sobrecompra, as vendas registradas e a posição após cada execução.
  6. Repita a observação em condições de mercado variadas e documente o que encontrou.

Inclua situações em que não deveria haver compra. Se o IFR atual continua abaixo do limite, ele ainda não saiu da região; se o valor anterior já estava acima, a primeira comparação da regra não é atendida.

Observe também um sinal que surge enquanto a barra está em formação e desaparece antes do fechamento. O teste ajuda a distinguir o que se vê no gráfico final do que a estratégia pode ter avaliado durante a barra.

Ao experimentar outros parâmetros, altere um de cada vez e registre a razão da mudança. Reserve períodos distintos para ajustar e verificar a lógica: essa separação ajuda a não tomar uma adaptação ao histórico como prova de consistência.

O que a implementação não resolve

O código não inclui ordem de proteção por perda, ou stop, nem uma meta de lucro definida por preço. Sair por uma condição do IFR não equivale a estabelecer um limite financeiro para a posição.

Caso o preço siga caindo após a compra, não há uma regra específica de saída para essa situação. A posição pode continuar exposta enquanto o IFR não alcança a região de sobrecompra.

  • Perda: não foi programado um encerramento específico para limitar perdas.
  • Tempo: o código não estabelece uma hora para fechar a posição.
  • Ordens: solicitar o envio não é o mesmo que confirmar a execução.
  • Despesas: a lógica não calcula os custos operacionais.
  • Conferência de estado: não estar comprado, isoladamente, não descreve toda a situação da conta.

A quantidade também merece atenção. Antes do teste, confira a interação entre Lote e a configuração da automação; depois de cada execução, verifique se a posição registrada e a quantidade coberta são as esperadas.

A distinção essencial é entre sinal, ordem solicitada e posição efetivamente executada. Mesmo que a condição seja reproduzida corretamente, a operação pode se comportar de forma inadequada se os demais estados não forem tratados.

Para levar do estudo

  • Um IFR baixo, sozinho, não aciona a entrada: a regra procura sua passagem para cima do limite de sobrevenda.
  • A saída depende do nível atual de sobrecompra e da posição comprada, sem comparação com a barra anterior.
  • As barras coloridas são recursos visuais; a execução deve ser conferida nos registros.
  • Não há no exemplo stop por perda, fechamento por horário ou cálculo de despesas.
  • Em replay ou simulador, acompanhe separadamente as condições, as ordens e as posições.

Atenção aos riscos

O conteúdo tem finalidade educativa e não é recomendação personalizada de investimento. Mantenha este exemplo em replay ou simulador: o IFR pode produzir sinais falhos, operações podem gerar perdas e testes não garantem desempenho futuro.

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.