Uma estratégia automatizada precisa cuidar tanto da abertura quanto do encerramento de uma posição. Ao planejar duas saídas, também é essencial verificar se a ordem que sobra deixa de estar ativa quando a posição é encerrada.
Vamos examinar uma rotina em NTSL que envia uma compra e calcula preços para alvo e stop. O objetivo é compreender suas decisões e seus limites, além de preparar uma verificação em simulador ou replay. O exemplo é didático e não está pronto para ser usado como automação real.
Qual é a função de uma OCO?
A sigla OCO, de one cancels the other, descreve uma relação entre ordens na qual a execução de uma leva ao cancelamento da outra. Para uma posição comprada, essa relação pode organizar uma saída por alvo e outra por stop, evitando que uma ordem desnecessária permaneça ativa depois do encerramento.
- Alvo: nível previsto para sair em um movimento favorável, geralmente com uma ordem limitada.
- Stop: nível que aciona uma ordem de saída diante de um movimento adverso.
- Relação OCO: mecanismo que associa as saídas para cancelar a complementar quando necessário.
A presença de duas chamadas de saída não é prova de que elas estão vinculadas como OCO. A rotina não escreve uma vinculação explícita: é preciso verificar como o ambiente lida com as ordens de cobertura recebidas.
Por isso, a análise vai além dos preços exibidos no gráfico. Acompanhe o envio e a execução de cada ordem, a posição resultante e a situação da saída complementar até confirmar que ela foi cancelada.
input
Quantidade(1);
DistanciaAlvo(100);
DistanciaStop(50);
var
precoEntrada : Float;
precoAlvo : Float;
precoStop : Float;
begin
// Condição simples para entrada: rompe máxima anterior
if (not HasPosition()) and (Close > High[1]) then
begin
precoEntrada := Close;
// Envia ordem de compra a mercado
BuyAtMarket(Quantidade);
end;
// Se comprado, calcula preço de alvo e stop e envia as ordens OCO
if IsBought() then
begin
precoAlvo := precoEntrada + DistanciaAlvo;
precoStop := precoEntrada - DistanciaStop;
// Envia ordem de venda alvo (limitada)
SellToCoverLimit(precoAlvo, Quantidade); { Alvo }
// Envia ordem de stop (OCO) vinculada
SellToCoverStop(precoStop, precoStop, Quantidade); { Stop }
end;
end;Rotina de compra e saídas em NTSL
A rotina apresentada reúne uma condição de entrada e duas chamadas de saída. Ela permite estudar a organização do código, mas sua sintaxe e seu comportamento precisam ser verificados no ambiente em que será testada.
Quantidade e distâncias são valores escolhidos para ilustrar as contas: não são cotações nem parâmetros recomendados. Antes de executar o teste, confira a documentação oficial das funções e a compatibilidade com a versão instalada.
No início da rotina, os parâmetros Quantidade, DistanciaAlvo e DistanciaStop definem os valores usados nas chamadas e nos cálculos.
As variáveis precoEntrada, precoAlvo e precoStop guardam, respectivamente, a referência da compra e os dois preços de saída calculados.
Sem posição e com Close acima de High[1], a rotina armazena Close e envia uma compra a mercado com BuyAtMarket.
Quando IsBought() indica uma posição comprada, o alvo é calculado acima da referência armazenada e o stop, abaixo dela.
A chamada SellToCoverLimit solicita a venda limitada no preço calculado para o alvo.
Já SellToCoverStop recebe o preço de stop duas vezes e a quantidade configurada. O comentário sobre OCO expressa a intenção do exemplo; não confirma, por si só, a vinculação das ordens.
Código destinado ao estudo
Experimente a rotina somente em simulador ou replay. Mesmo que os comentários indiquem o propósito das saídas, é necessário testar o vínculo OCO, as execuções e o tratamento da posição na configuração escolhida.
Leitura da lógica passo a passo
Parâmetros e preços armazenados
A quantidade determina o tamanho informado nas chamadas de ordem, enquanto as distâncias definem as diferenças usadas nas saídas. A rotina soma ou subtrai esses valores diretamente do preço de referência; ela não os converte explicitamente em percentual, valor financeiro ou número de incrementos mínimos.
Separar os três preços em variáveis torna a rotina mais fácil de acompanhar. Ainda assim, precoEntrada é apenas o nome escolhido: o valor armazenado é Close no momento do sinal, e não uma confirmação do preço pelo qual a compra foi executada.
Quando a compra é solicitada
A entrada exige duas condições ao mesmo tempo: não haver posição e o valor de Close superar High[1], a máxima anterior. Nesse caso, o código registra Close como referência e chama BuyAtMarket(Quantidade).
A comparação procura identificar um preço acima da máxima anterior, mas isso não garante que a decisão ocorra exclusivamente após o fechamento confirmado da barra. Para interpretar o sinal corretamente, verifique quando a estratégia é avaliada na configuração usada.
Estar sem posição também não significa necessariamente estar sem ordem de entrada pendente. Como a rotina não verifica essa pendência explicitamente, observe o que ocorre se o sinal permanecer verdadeiro enquanto a compra ainda não foi confirmada.
Como as saídas são calculadas
Com IsBought() verdadeiro, a rotina soma DistanciaAlvo à referência e subtrai dela DistanciaStop. Depois, solicita a saída limitada pelo alvo com SellToCoverLimit e a saída por stop com SellToCoverStop.
As duas chamadas utilizam a mesma Quantidade configurada para a entrada. Verifique se ela ainda corresponde à posição existente, especialmente em situações de execução parcial ou de alteração da posição.
Na chamada de stop, precoStop aparece em dois argumentos. Consulte a documentação para identificar a função de cada um: se forem preço de disparo e preço limite, usar o mesmo valor pode resultar em uma ordem acionada, mas não executada, por falta de contraparte nesse nível.
Para adaptar essa rotina com critério, aprofunde o estudo de variáveis, funções de ordens e estados da posição na programação de estratégias.
Validação do ciclo de ordens
Comece examinando o funcionamento da rotina, sem usar o resultado financeiro como critério principal. Registre o que acontece desde o sinal até a execução e o cancelamento das ordens, comparando cada etapa com a lógica esperada.
- Verifique as funções na documentação oficial e tente compilar a rotina no editor.
- Execute o teste isoladamente, sem combinar as saídas do código com outras configurações de saída.
- Na compra, compare a referência armazenada com o preço confirmado da execução.
- Crie cenários separados para observar uma saída pelo alvo e outra pelo stop.
- Após cada saída, confira a posição e o cancelamento da ordem complementar.
- Quando o simulador permitir, repita a análise com execução parcial, movimento rápido e reinício do ambiente.
Como exercício hipotético, suponha que Close seja 2.000 quando o sinal aparece e que a compra seja executada a 2.004. Com as distâncias do código, as saídas calculadas ficam em 2.100 e 1.950. Em relação ao preço executado, essas diferenças são, respectivamente, 96 e 54.
Os números servem apenas para ilustrar a conta, sem representar uma operação real. A diferença aparece porque a rotina usa a referência do sinal, que pode não coincidir com o preço confirmado da compra.
Enquanto a posição continuar comprada, observe também as reavaliações das chamadas de saída e consulte os registros para entender como o ambiente as trata. Não presuma, sem testar, que ordens serão duplicadas ou atualizadas automaticamente.
- Preço de referência: compare o valor registrado antes do envio com o preço efetivamente executado.
- Quantidade coberta: confronte o tamanho das ordens de saída com a posição que permanece aberta.
- Ordem restante: confirme sua situação depois que a posição for encerrada.
- Nova entrada: observe se a rotina volta a comprar quando o sinal continua verdadeiro após a saída.
- Retomada: verifique os valores das variáveis após reiniciar o ambiente com uma posição aberta.
Uma ordem de stop não estabelece um limite absoluto de perda. Falta de liquidez, diferenças na execução e problemas operacionais podem alterar o resultado esperado. Além disso, o acionamento de uma ordem não garante que ela seja executada.
O que guardar do exemplo
- A rotina distingue o sinal de compra dos cálculos e das chamadas de saída.
precoEntradaregistra uma referência do sinal, não o preço confirmado da compra.- O funcionamento do vínculo OCO deve ser verificado no ambiente utilizado.
- Vale testar separadamente quantidades, pendências de entrada e possibilidade de reentrada.
- Uma compilação bem-sucedida não substitui os testes do comportamento das ordens.
Valide a rotina antes de acrescentar lógica
Antes de incluir novos filtros ou sinais, esclareça como a rotina percorre o ciclo de ordens. Os registros devem mostrar qual preço serviu de referência, quanto da posição foi coberto e o que aconteceu com a saída complementar.
Sempre que o código ou a configuração mudar, repita os testes pertinentes. Isso ajuda a manter a rotina compreensível e verificável, sem perder de vista que os resultados e as condições de uma simulação podem diferir da execução real.
Atenção aos riscos
Operações no mercado financeiro podem causar perdas. O conteúdo e o código têm finalidade educativa e não são uma recomendação personalizada de investimento. Estude a rotina em simulador ou replay: alvo, stop e automação não eliminam riscos de execução nem falhas operacionais.


