Como personalizar o mapa de instrumentos do Cross Order?

O recurso Cross Order do Replikanto permite que uma conta seguidora opere um instrumento diferente, mas relacionado, ao da conta líder. Por exemplo, você pode operar o E-mini S&P 500 (ES) na conta líder enquanto a conta seguidora executa a mesma operação no Micro E-mini (MES). O Cross Order muda o instrumento, não a quantidade: 1 contrato de ES no líder vira 1 contrato de MES no seguidor. Para operar outra quantidade de contratos, combine o Cross Order com o método de cópia Ratio.

Quais instrumentos cruzam para quais é definido por um mapa de famílias de instrumentos. O Replikanto tem um mapa embutido com 36 famílias (veja o Mapa de Instrumentos do Cross Order: Futuros e Níveis Suportados), e você pode substituí-lo pelo seu próprio arquivo ReplikantoCrossOrderRelationship.json. Este artigo explica o formato do arquivo, como criá-lo ou editá-lo e o que fazer com um arquivo existente depois de atualizar para o Replikanto 1.7.0.0.

Como o arquivo funciona

• Local: Documents\NinjaTrader 8\bin\Custom\ReplikantoCrossOrderRelationship.json. O Replikanto procura o arquivo somente ali, com exatamente esse nome.
• Não ter o arquivo é normal. Se o arquivo não existe, o Replikanto usa o mapa embutido. Você só precisa do arquivo se quiser uma família ou um nível que o mapa embutido não tem, ou se quiser alterar ou remover algum.
• O arquivo substitui o mapa embutido inteiro. Quando o arquivo existe e tem pelo menos uma entrada válida, o Replikanto usa apenas as famílias do seu arquivo. Uma família que não estiver no arquivo simplesmente não cruza. Por isso, comece pelo arquivo completo que acompanha o Replikanto e edite-o, em vez de criar um arquivo só com a sua inclusão.
• Quando é lido: sempre que uma janela ou aba do Replikanto é aberta. Fechar e reabrir a janela do Replikanto (ou reiniciar o NinjaTrader) aplica as suas alterações.

Formato do arquivo

O arquivo contém uma lista, CrossOrders, com uma entrada por família de instrumentos:

{
  "CrossOrders": [
    { "mini": "ES", "micro": "MES", "nano": "NES" },
    { "mini": "6B", "micro": "M6B" }
  ]
}

• Cada entrada precisa de mini e micro; nano é opcional. Uma entrada sem mini ou sem micro é ignorada.
• Use os nomes dos instrumentos como o Instrument Manager do NinjaTrader os lista (por exemplo ES, e não um vencimento como ES 12-26). O seguidor sempre opera o mesmo vencimento do instrumento da aba.
• As chaves mini, micro e nano são a primeira, a segunda e a terceira posição da família — a ordem em que o quadrado do Cross Order passa por elas. Não precisam ser literalmente contratos mini, micro e nano; por exemplo, a família embutida de Petróleo é CL / MCL / QM.
• Uma família pode ter no máximo três níveis, e cada símbolo só pode aparecer uma vez no arquivo inteiro. Uma entrada que repete um símbolo já usado em outra entrada é pulada, e a aba Log mostra o Warning Replikanto: [CrossOrder] Skipped a Cross Order relationship because one of its instruments is already mapped elsewhere.
• Arquivos antigos que descreviam uma família de três níveis como dois pares encadeados (por exemplo GC→MGC mais MGC→1OZ) continuam funcionando: o Replikanto junta os dois numa família só.
• Linhas que começam com // são tratadas como comentários; o arquivo que acompanha o Replikanto usa esses comentários para identificar cada família.
• Se o arquivo não puder ser lido como um JSON válido nesse formato, o Replikanto registra o Warning Replikanto: [CrossOrder] Could not read ReplikantoCrossOrderRelationship.json, falling back to the built-in mini/micro/nano relationships. na aba Log e usa o mapa embutido no lugar.

Instruções Passo a Passo

1. Obtenha o arquivo atual
   Pegue o ReplikantoCrossOrderRelationship.json do arquivo de instalação do Replikanto 1.7.0.0 (Replikanto-1.X.X.X-xxxxx.zip) ou baixe-o na seção de downloads do seu perfil FlowBots. O arquivo do 1.7.0.0 contém o mapa completo de 36 famílias.
2. Faça backup de qualquer arquivo existente
   Se Documents\NinjaTrader 8\bin\Custom já tiver um ReplikantoCrossOrderRelationship.json, faça uma cópia de backup antes de substituí-lo ou editá-lo.
3. Edite o arquivo
   Abra o arquivo JSON em um editor de texto e inclua, altere ou remova entradas seguindo o formato acima.
4. Salve o arquivo
   Salve-o em Documents\NinjaTrader 8\bin\Custom. Não altere o nome do arquivo.
5. Reabra o Replikanto
   Feche e reabra a janela do Replikanto, ou reinicie o NinjaTrader, para que as alterações tenham efeito.
6. Verifique a configuração
   Procure na aba Log algum Warning com [CrossOrder]. Depois selecione na aba um dos instrumentos da sua família e confirme que a coluna Cross Order aparece e passa pelos instrumentos que você definiu.

1 = um dos instrumentos da sua família na aba (aqui, ES 12-26); 2 = Cross Order marcado no menu que abre quando você clica com o botão direito no painel esquerdo; 3 = a coluna Cross Order. Clique no quadrado de um seguidor para passar pelos instrumentos que você definiu.

Exemplo de Configuração

Petróleo é um exemplo comum. O mapa embutido já o traz como uma família de três níveis, { "mini": "CL", "micro": "MCL", "nano": "QM" }. Se você quer que o CL cruze apenas para o MCL, altere essa entrada no seu arquivo para { "mini": "CL", "micro": "MCL" }.

Depois de alterar a entrada para { "mini": "CL", "micro": "MCL" }, uma aba de CL tem só dois estados: 1 = desligado (cinza), a Sim102 opera CL; 2 = verde, a Sim103 opera MCL.

A versão 1.4.5.4 do Replikanto e superior inclui o relacionamento de ordem cruzada CL <> MCL pré-configurado pronto para uso.

Atualizou para o 1.7.0.0 e tem seu próprio arquivo?

A atualização automática do Replikanto nunca sobrescreve o ReplikantoCrossOrderRelationship.json. Qualquer cópia do arquivo anterior ao 1.7.0.0 — personalizada ou não — continua valendo depois da atualização e mantém o mapa antigo de 26 famílias: sem os níveis nano e sem nenhuma das 10 famílias incluídas no 1.7.0.0.

• Como identificar: abra o arquivo. Se nenhuma entrada tem a chave "nano" e não há entradas para as famílias incluídas no 1.7.0.0 (como FESX ou SOL), é o mapa antigo.
• Você nunca personalizou o arquivo, ou o novo mapa já cobre as suas alterações: apague o arquivo. O Replikanto passa a usar o mapa embutido de 36 famílias.
• Você tem alterações que o novo mapa não cobre: substitua o arquivo pelo do arquivo de instalação do 1.7.0.0 e refaça as suas alterações.
• Instalação pela importação do .zip: se você instala uma nova versão importando o .zip no NinjaTrader e o NinjaTrader perguntar se deve substituir um arquivo existente, responder que sim troca o seu arquivo pelo novo mapa de 36 famílias. Faça backup do seu arquivo antes.

Três Níveis para o Mesmo Produto do Líder

Antes do Replikanto 1.7.0.0, um instrumento do líder podia ser mapeado para exatamente um instrumento cruzado. A partir do 1.7.0.0, uma família pode ter até três níveis, então o quadrado do Cross Order passa por desligado (cinza), o primeiro outro nível da família (verde) e o segundo outro nível (amarelo), na ordem mini, micro, nano, pulando o próprio instrumento da aba. Com ES na aba, o verde é MES e o amarelo é NES; com MES na aba, o verde é ES e o amarelo é NES. A grade mostra, ao lado do quadrado, o instrumento que aquele seguidor vai operar.

Uma aba de ES com um seguidor em cada estado: 1 = desligado (cinza), a Sim102 opera o próprio ES da aba; 2 = verde, a Sim103 opera MES; 3 = amarelo, a Sim104 opera NES.

Uma família que você definir só com mini e micro mantém o comportamento conhecido de cinza/verde. Veja Cross Order Agora Tem Três Níveis de Instrumento (1.7.0.0) para a explicação completa.

Considerações Importantes

• Localização do arquivo: Certifique-se de que o arquivo modificado seja salvo no diretório correto: Documents\NinjaTrader 8\bin\Custom. Se o arquivo estiver no local errado, o Replikanto não detectará suas personalizações.
• Sem limitações codificadas: Não há limite fixo no número de famílias que você pode definir. Cada família pode ter até três níveis.
• Tipos de instrumentos suportados: O Cross Order funciona melhor ao converter entre versões micro, mini e nano do mesmo ativo subjacente (por exemplo, ES para MES, NQ para MNQ, CL para MCL). Os instrumentos devem ter movimentos de preços equivalentes para que a conversão funcione corretamente.
• Incrementos de preço diferentes são tratados automaticamente: Se o instrumento para o qual você cruza variar em um incremento de preço diferente do instrumento do líder, o Replikanto 1.7.0.0 arredonda o preço da ordem copiada para um preço válido no instrumento do seguidor, em vez de deixar a corretora rejeitá-la. Preços de compra são arredondados para baixo e preços de venda para cima. Isso vale para pares como GC/1OZ, CL/QM, SI/SIC e VX/VXM, e para qualquer família que você incluir.
• Conversões não suportadas: Ordens cruzadas entre instrumentos com estruturas de preços diferentes não são possíveis, como:
  • ETFs vs. futuros (por exemplo, QQQ <> NQ ou SPY <> ES)
  • Instrumentos futuros com diferentes datas de vencimento
  • Instrumentos de diferentes classes de ativos
• Alguns pares exigem uma bolsa específica: Cruzar VIX (VX) com Micro VIX (VXM) só é resolvido em uma conexão de corretora que consiga acessar a Cboe CFE, como a Interactive Brokers. A NinjaTrader Brokerage não oferece suporte a essa bolsa.
• Relacionamentos predefinidos: O Replikanto inclui um mapa embutido com 36 famílias. O seu arquivo o substitui, então mantenha no arquivo todas as famílias que você ainda quer usar.
• Negociação de múltiplos instrumentos: Se você precisa copiar vários símbolos de uma conta líder para seguidores, abra uma aba separada para cada símbolo. O Replikanto pode funcionar com várias janelas ou abas em paralelo.
• Baixar o arquivo original: Você pode baixar o arquivo ReplikantoCrossOrderRelationship.json original na seção de downloads do seu perfil FlowBots.
• Validação de sintaxe JSON: Certifique-se de que a sintaxe JSON esteja correta ao editar o arquivo. Se o arquivo não for válido, o Replikanto registra um Warning e volta a usar o mapa embutido, ou seja, as suas alterações não são aplicadas. Considere usar um validador JSON se você não tiver certeza sobre a sintaxe.
• Depois de trocar o instrumento da aba: Cada seguidor com um destino de Cross Order mantém o seu nível, a mesma posição (mini, micro ou nano) na família do novo instrumento: um seguidor configurado para MES numa aba de ES passa a operar MNQ quando a aba muda para NQ. Se a nova família não tem equivalente nesse nível, como um destino nano (o NES, por exemplo) quando a aba muda para CL ou NG (o terceiro nível deles é um E-mini maior), o Replikanto desliga o seguidor (Off) em vez de deixá-lo operar o próprio instrumento da aba, que pode ser bem maior, e registra um Warning na aba Log. O mesmo acontece quando você carrega seguidores pelo Import... do menu da grade de seguidores ou liga o Cross Order na aba, e com um seguidor cuja conexão estava caída durante a troca: ele volta desligado. O Ligar (Toggle on) não religa um seguidor assim, e ele continua desligado quando você reabre o workspace. Se você marcar o Status dele sem escolher antes um destino de Cross Order, o Replikanto apaga o destino antigo e o seguidor passa a operar o próprio instrumento da aba, como mostra o quadrado do Cross Order dele; a aba Log informa isso. Confira o Ratio dele para esse contrato. Escolha um destino para ele, ou desligue o Cross Order dele, antes de ligá-lo de novo. Voltar a aba para a família do destino o restaura, a menos que você tenha marcado o seguidor nesse meio-tempo sem escolher um destino. Um seguidor que foi desligado continua desligado até você marcá-lo de novo.

Solução de Problemas

• Alterações não aparecem: Verifique se o arquivo foi salvo no diretório correto e se o nome do arquivo não foi alterado, depois feche e reabra a janela do Replikanto. Procure na aba Log um Warning com [CrossOrder]: "Could not read ReplikantoCrossOrderRelationship.json" indica erro de sintaxe (o mapa embutido está em uso); "Skipped a Cross Order relationship" indica um símbolo usado duas vezes.
• Arquivo não encontrado: Isso é normal — sem o arquivo, o Replikanto usa o mapa embutido. Extraia o arquivo do instalador Replikanto-1.X.X.X-xxxxx.zip somente se quiser personalizar o mapa.
• Uma família que você não alterou parou de cruzar: o seu arquivo substitui o mapa embutido inteiro. Inclua essa família no seu arquivo, ou recomece a partir do arquivo completo do 1.7.0.0.
• Nenhum nível nano depois de atualizar para o 1.7.0.0: uma cópia antiga do arquivo ainda está em Documents\NinjaTrader 8\bin\Custom. Veja "Atualizou para o 1.7.0.0 e tem seu próprio arquivo?" acima.
• Ordens não convertem: Confirme que a família está definida corretamente no arquivo JSON e que os dois instrumentos estão disponíveis no Instrument Manager do NinjaTrader para o mesmo vencimento. Se a aba Log mostrar No cross order instrument is mapped for this instrument com um símbolo, o NinjaTrader não encontrou esse instrumento na sua conexão.
• Configurações existentes após a atualização: Workspaces salvos e configurações de seguidores que já tinham o Cross Order ativado continuam funcionando automaticamente após a atualização para o 1.7.0.0. Não há etapa de migração, e elas continuam resolvendo para o mesmo instrumento que já cruzavam antes. Os seguidores que já estavam com o Cross Order ligado antes do Replikanto 1.7.0.0 continuam cruzando exatamente como antes, pelo mapa anterior; para usar as novas famílias ou o nível nano, clique no quadrado do Cross Order do seguidor até ele mostrar o destino que você quer.