Unknown symbol '' was received. Check your symbol map.

Este artigo explica o que significam os erros "unknown symbol" e "Could not find symbol for contract id" no log do NinjaTrader, por que eles impedem o Replikanto de copiar as negociações para as contas seguidoras e como resolvê-los atualizando o banco de dados de instrumentos do NinjaTrader.

Sintomas

Quando o NinjaTrader não consegue identificar o instrumento das negociações feitas no TradingView, erros como estes passam a aparecer nos logs do NinjaTrader (aba Log do Centro de Controle):

2025-01-XX XX:XX:XX:XXX|3|32|Order '123456789101112' received for unknown symbol ''
2025-01-XX XX:XX:XX:XXX|2|32|An execution for unknown symbol '' was received. Check your symbol map.
2025-01-XX XX:XX:XX:XXX|3|32|Could not find symbol for contract id '4399654'

O mesmo problema também pode aparecer sozinho, como uma mensagem "Could not find symbol for contract id" (com o id interno do contrato) na aba Log do Centro de Controle.

Por que isso acontece

Normalmente acontece logo após a virada trimestral dos futuros (rollover), quando o banco de dados de instrumentos do NinjaTrader ainda não foi atualizado para o novo contrato vigente.
Sem a identificação do símbolo pelo NinjaTrader, a negociação não pode ser reconhecida. Com isso, os add-ons — os nossos ou de terceiros — deixam de funcionar corretamente: a cópia para os seguidores não acontece e as contas ficam fora de sincronia.
Nenhum add-on executado no NinjaTrader é responsável por relacionar os símbolos das negociações. Essa responsabilidade é do próprio NinjaTrader.

Como resolver

1. Redefina seus instrumentos

Desconecte todas as conexões ativas no menu suspenso Centro de Controle > Conexões.
Abra a janela Centro de Controle > Ferramentas > Gerenciamento de Banco de Dados.
Na seção Atualizar instrumentos, deixe marcadas as opções Propriedades gerais, Vencimentos de futuros e Mapeamentos de símbolos e clique em Atualizar.
Reinicie o NinjaTrader e teste novamente.

2. Confirme que o novo contrato está disponível

Se o novo mês de contrato continuar faltando depois da atualização, faça o rollover na mesma janela Ferramentas > Gerenciamento de Banco de Dados: a grade em Avançar símbolos futuros mostra cada instrumento elegível — clique em avançar para levá-lo ao próximo mês de contrato. Você também pode digitar o próximo contrato (por exemplo, ES 12-26) direto no seletor de instrumentos e pressionar Enter.

3. Confira o contrato no Replikanto

O instrumento exibido na janela do Replikanto precisa ser o mesmo contrato negociado na conta líder. Se você opera pelo TradingView ou pelo Tradovate, lembre-se de que o NinjaTrader costuma pedir a rolagem alguns dias antes do Tradovate — leia o guia de rolagem abaixo antes de aceitar o aviso de rollover do NinjaTrader.

Se o erro continuar

Como o problema está no software NinjaTrader, quem pode ajudar melhor é a equipe de suporte deles, em portuguese@ninjatrader.com. Peça para falar com um atendente humano para relatar o problema — o agente de suporte com IA do NinjaTrader ainda não consegue tratar esse caso específico.

Assim que o NinjaTrader voltar a identificar o símbolo corretamente, o Replikanto copiará as negociações normalmente.