Exportar e importar a lista de seguidores do Replikanto

Este artigo mostra como salvar as contas seguidoras de uma aba do Replikanto em um arquivo de texto (Export...) e carregá-las de volta (Import...), por exemplo para ter um backup, levar a configuração para um computador ou VPS novo, ou copiá-la para outro workspace. Também explica o que mudou no Replikanto 1.7.0.0 e o que fazer se uma importação numa versão anterior trouxe os seguidores de volta com o Ratio errado ou desligados.

O que é o arquivo de seguidores

O Export grava um arquivo .txt simples (nome padrão Followers.txt) com uma linha para cada conta listada na grade Contas Seguidoras (Follower Accounts) da aba. Cada linha traz as configurações de cópia daquela conta: se está ligada, ATM Copy, Cross Order, Ratio, Alocação Prévia (Pre Allocation), Alteração Pct. (Pct. Change, a coluna %) e Market Only.

Os dois seguidores do exemplo em Formato do arquivo, mais abaixo. O que o arquivo guarda de cada conta: 1 = ligada/desligada, 2 = Ratio, 3 = ATM Copy, 4 = Market Only, 5 = Cross Order. Alocação Prévia e % também são gravados; essas colunas só aparecem com os métodos de cópia correspondentes.

O arquivo guarda só a lista de seguidores. Ele não é um workspace do NinjaTrader: a conta líder, o instrumento, as propriedades e o resto da aba ficam salvos no workspace, não neste arquivo.

Exportar a lista de seguidores

1. Abra a aba do Replikanto cujos seguidores você quer salvar.
2. Clique com o botão direito em qualquer ponto da grade Contas Seguidoras.
3. Clique em Export... (esse item aparece em inglês mesmo com o NinjaTrader em português).
4. Escolha a pasta e o nome (o padrão é Followers.txt) e clique em Salvar.

Botão direito na grade Contas Seguidoras > Export...

Importar a lista de seguidores

1. Abra a aba do Replikanto que você quer configurar, já com a conta líder e o instrumento selecionados.
2. Clique com o botão direito na grade Contas Seguidoras e clique em Import... (também aparece em inglês).
3. Selecione o arquivo e clique em Abrir. Cada conta citada no arquivo recebe as configurações do arquivo. As contas que não estão no arquivo não são alteradas.
4. Confira a grade e salve o workspace (Workspaces > save no Control Center do NinjaTrader). Enquanto o workspace não for salvo, as configurações importadas não ficam guardadas para o próximo início do NinjaTrader.

Botão direito na grade Contas Seguidoras > Import...

Cada conta importada fica registrada na aba Log do NinjaTrader (Control Center > Log) numa linha que começa com Replikanto: [Workspace] Imported a follower account from file. e mostra o status, o Ratio e os demais valores com que o seguidor ficou.

O que acontece na importação

A partir do Replikanto 1.7.0.0:

• Funciona com qualquer idioma do Windows. Os valores de Ratio e % são lidos do mesmo jeito em qualquer computador. Um arquivo exportado num computador que usa vírgula decimal, como o Windows em português ou em alemão, é lido corretamente, inclusive com Ratio e % fracionários (por exemplo 0.5 ou 1.125). Isso vale também para arquivos de seguidores exportados por versões antigas do Replikanto.
• Contas ainda não conectadas são mantidas. Se o arquivo cita uma conta que ainda não tem linha na grade (em geral porque a conexão com a corretora ainda está subindo), o Replikanto guarda as configurações dela e as aplica assim que a conta aparecer. O Log mostra um Warning [1069] para essa conta. Se o nome não for de uma conta sua, procure um erro de digitação no arquivo.
• Um valor inválido não zera o seguidor. Se um campo de uma linha não puder ser lido, ou estiver fora do intervalo que a grade aceita (Ratio de -100 a 100, ou de 0 a 100 na edição Compliance Mode; % de -100 a 100), o seguidor mantém o valor atual desse campo e o resto da linha é aplicado normalmente. O Log mostra um Warning [1066], e field= indica o campo. Corrija esse valor no arquivo e importe de novo.
• Os seguidores voltam armados. Um seguidor que estava Disarmed ou Out of sync quando o arquivo foi exportado é importado ligado (armado). Se ligá-lo criaria um loop de cópia com outra aba do Replikanto, ele fica desligado (Off).
• Um destino de Cross Order sem equivalente nesta aba volta desligado. Com o Cross Order ligado na aba, uma linha cujo destino de Cross Order não tem equivalente para o instrumento da aba (por exemplo NES importado numa aba de CL) é importada desligada (Off), para que esse seguidor não opere o contrato cheio do líder. Escolha um destino de Cross Order válido para ela e ligue-a.
• Market Only prevalece sobre o ATM Copy. Se a linha tem Market Only ligado, o ATM Copy é desligado para esse seguidor, como acontece na grade.

Import... está desabilitado (cinza)

Com a propriedade Bloquear as definições do seguidor durante uma operação (Lock follower settings while in a trade) ligada (nas propriedades, seção Geral; vem ligada por padrão), o Import... fica desabilitado enquanto uma conta seguidora ligada da aba (que não esteja desligada nem desarmada) tiver uma posição aberta ou uma ordem ativa, ou enquanto a conta líder tiver uma posição aberta. Ao passar o mouse sobre o item aparece: "Pelo menos uma conta seguidora desta aba tem uma posição aberta ou uma ordem ativa. Zere essa conta, ou aguarde o fim da operação, antes de alterar esta configuração."

1 = os seguidores desta aba estão em operação (posição aberta e ordens ativas); 2 = Import... fica em cinza. O Export... continua disponível.

Zere as contas, ou espere a operação terminar, e depois importe. O Export... continua disponível durante a operação.

Propriedades > Geral > Bloquear as definições do seguidor durante uma operação (ligada por padrão).

Problemas de importação em versões anteriores

Antes do Replikanto 1.7.0.0, importar um arquivo de seguidores num computador que usa vírgula decimal (por exemplo Windows em português ou alemão) podia trazer os seguidores de volta com Ratio 1 e desligados (Off), ou com um Ratio fracionário lido como um número muito maior (um Ratio exportado de 1,125 voltava como 1125), enquanto o Log ainda informava que a importação tinha dado certo. Contas cuja corretora ainda não estava conectada também eram ignoradas.

Para resolver, atualize o Replikanto para o 1.7.0.0 ou posterior e importe o mesmo arquivo de novo: agora ele é lido corretamente. Depois confira o Ratio e o % de cada seguidor e salve o workspace.

Formato do arquivo

Normalmente você não precisa editar o arquivo. Para referência, cada linha tem oito campos separados por ponto e vírgula, nesta ordem:

Conta;ATM Copy;Cross Order;Ratio;Pre Allocation;%;Status;Market Only
Sim101;False;False;1;0;0;Checked;False
Sim102;True;MES;0.5;0;0;Checked;False

• Os números usam ponto decimal e não têm separador de milhar, em qualquer idioma do Windows.
• Cross Order é False quando não é usado; caso contrário, traz o destino do Cross Order.
• Status é Off (desligada) ou Checked (ligada). O arquivo também pode ter Disarmed ou OutOfSync, que são importados como ligada.

Se editar o arquivo à mão, mantenha os nomes das contas exatamente como o NinjaTrader os mostra.

Listas de nós

A grade de nós da rede local e a grade de nós remotos têm seus próprios itens Import... e Export... no menu do botão direito (nomes padrão Nodes.txt e RemoteNodes.txt). Funcionam do mesmo jeito e guardam só a lista de nós.