Como transferir histórico cripto entre rastreadores

Como transferir o histórico de transações de criptomoedas de um rastreador para outro

Mudar de rastreador de portfólio pode parecer uma simples transferência de arquivos. A parte difícil é preservar os detalhes que dão contexto a cada registro: de qual carteira veio, se a transferência foi interna e que observação você adicionou. Um arquivo CSV pode conter as transações visíveis, mas deixar de fora etiquetas ou outros dados relevantes. Uma migração cuidadosa mantém o histórico utilizável no novo rastreador e garante uma referência confiável caso algo não corresponda.

Se você está pesquisando como transferir histórico de transações de criptomoedas, encare o processo como uma migração, e não como uma importação com um só clique. O destino pode interpretar a mesma linha de outra forma, especialmente se os campos ou as regras forem diferentes dos do aplicativo antigo. As verificações abaixo ajudam a identificar essas diferenças antes que você passe a confiar no novo rastreador.

1. Identifique o que precisa ser transferido

Comece definindo o escopo. Anote o período necessário, todas as carteiras e contas de corretoras incluídas no rastreador antigo e os registros que espera encontrar no destino. Não se limite às negociações: depósitos, saques, taxas, recompensas de staking, airdrops e transferências entre suas próprias carteiras também podem ser importantes.

Vá além da lista de transações. Se você usava etiquetas, observações personalizadas, ajustes no custo de aquisição ou nomes de contas, decida se esses detalhes também precisam ser transferidos. Uma transferência marcada como “entre minhas carteiras” tem um significado diferente de um saque para um endereço desconhecido, mesmo que as duas linhas indiquem a saída de um ativo.

Faça um breve inventário antes de exportar. Por exemplo, você pode listar duas contas de corretoras, três carteiras e todos os registros desde o primeiro dia em que usou o rastreador antigo até o último dia já concluído. Esse inventário vira uma lista de verificação para o destino e pode revelar uma conta que estava conectada, mas nunca foi incluída na migração.

2. Verifique o que o rastreador de destino consegue importar

Consulte a documentação atual de importação do rastreador de destino antes de preparar os arquivos. Verifique quais formatos ele aceita, quais tipos de transação reconhece e de quais colunas precisa. Os recursos dos produtos podem mudar, então confirme os limites atuais, os campos compatíveis e o comportamento da importação na documentação do rastreador, em vez de confiar em um tutorial antigo.

Compare essas informações com as opções de exportação do rastreador de origem. Um aplicativo pode oferecer um CSV geral, enquanto outro separa negociações, transferências e recompensas em arquivos diferentes. O destino pode aceitar CSV, mas exigir nomes específicos para as colunas, ou oferecer conexão com uma corretora sem importar observações históricas. Antes de tentar exportar e importar transações cripto em CSV, resolva essas diferenças.

Preste atenção especial aos tipos de transação. Se o destino não tiver uma categoria específica para determinada recompensa ou ajuste, não a reclassifique como negociação sem verificar. Consulte as orientações do rastreador ou pergunte à equipe de suporte como representar esse registro. Uma categoria incorreta pode afetar relatórios futuros, mesmo quando a quantidade do ativo parece certa.

3. Preserve os registros do rastreador antigo antes de alterar qualquer coisa

Guarde uma cópia local dos dados de origem antes de editar arquivos ou desconectar qualquer conta. Salve os arquivos originais de exportação em uma pasta com nomes claros, incluindo o nome do rastreador e o período no nome de cada arquivo. Se o aplicativo antigo permitir exportações separadas de transações, etiquetas, observações ou configurações de conta, salve esses dados também.

Não sobrescreva os arquivos originais ao ajustar as colunas para importação. Em vez disso, crie uma cópia de trabalho. Assim, se um valor for alterado por engano ou um lote for rejeitado, você poderá comparar o arquivo editado com o original. Um arquivo de cópia arquivado como somente leitura geralmente basta; o importante é conseguir encontrar a versão intacta depois.

Se as opções de exportação não incluírem observações ou configurações, preserve-as de outra forma. Uma captura de tela datada ou um breve registro por escrito pode ajudar, embora não substitua dados estruturados. Por exemplo, anote que uma determinada etiqueta de carteira no aplicativo antigo se referia à sua carteira física, e não a uma conta de corretora. Guarde essa referência junto com a exportação.

4. Associe os campos de origem aos campos de destino

Antes de importar, compare as colunas da origem e do destino, uma a uma. No mínimo, confira datas e horários, símbolos dos ativos, quantidades, taxas, IDs de transação e etiquetas. Verifique se o destino exige uma data em formato específico, uma taxa em campo separado ou um código de ativo diferente do símbolo usado na origem.

Não tente adivinhar quando um campo não tiver um equivalente claro. Se a origem usa uma coluna para o tipo de transação e o destino separa o tipo da direção, confirme como fazer a correspondência. Uma associação incorreta pode transformar um depósito em uma negociação ou fazer uma transferência de saída parecer uma venda. Anote os campos que gerarem dúvidas e esclareça-os consultando a documentação atual.

Examine os horários com atenção. A origem pode registrar a hora local, enquanto o destino pode exibir UTC ou converter as datas de acordo com as configurações da conta. Após a importação, um registro próximo da meia-noite pode aparecer em outro dia do calendário sem estar ausente. Compare o horário e o ID da transação, não apenas a data exibida.

Os símbolos dos ativos também podem ser ambíguos. Se dois ativos tiverem nomes parecidos ou o rastreador usar um símbolo renomeado, confirme a identidade do ativo antes de aceitar a associação. Em transações na blockchain, o ID da transação ou o endereço da carteira pode ajudar a distinguir registros com a mesma data e o mesmo valor.

5. Importe seguindo uma sequência controlada

Comece com uma amostra pequena e representativa, em vez de enviar todos os arquivos de uma vez. Escolha alguns registros que cubram situações diferentes: uma negociação com taxa, uma transferência recebida, uma transferência enviada e um registro com etiqueta personalizada. Importe-os para o destino e confira os lançamentos resultantes antes de continuar.

Verifique se o destino interpretou cada registro de teste como esperado. Confira o ativo, a quantidade, o horário, a taxa, o tipo de transação e todas as observações disponíveis. Se a prévia da importação mostrar um aviso ou algum campo estiver na coluna errada, pare e corrija o arquivo de trabalho. Um teste pequeno pode evitar muito trabalho de correção.

Quando a amostra estiver correta, importe o restante do histórico em lotes manejáveis. Você pode separar os arquivos por conta ou período, conforme as instruções do rastreador. Anote cada arquivo importado e a data da importação. Se um lote falhar, esse registro ajuda a identificar o que falta sem precisar repetir todo o processo.

Se um lote for rejeitado, salve a mensagem de erro e o arquivo rejeitado. Evite enviar o mesmo arquivo repetidamente até confirmar se a primeira tentativa criou registros parciais.

6. Evite duplicatas e reconcilie os totais

Antes de importar, verifique se o destino já sincroniza as mesmas carteiras ou corretoras. Se houver uma conexão ativa com uma conta, o rastreador pode já ter importado parte ou todo o histórico. Importar um arquivo por cima dos registros sincronizados pode criar duplicatas, mesmo quando as linhas parecem quase idênticas.

Descubra como o destino identifica duplicatas. Se não estiver claro como elas são tratadas, teste com um registro conhecido ou consulte o suporte antes de importar o histórico completo.

Após cada lote, compare os dados do destino com os da origem. Confira a quantidade de transações para a mesma conta e o mesmo período e, em seguida, compare os saldos em alguns momentos. Analise depósitos, saques, negociações e taxas representativos. A correspondência dos totais, por si só, não basta: dois registros ausentes e duas duplicatas podem se anular.

Tenha cuidado especial com transferências entre suas próprias carteiras. O rastreador de origem pode exibir tanto a saída quanto a entrada, enquanto o destino pode vinculá-las como uma única movimentação interna. Confirme que a quantidade do ativo não está sendo contabilizada duas vezes como ganho ou perda. Se houver uma taxa de rede, verifique se ela continua visível como custo separado, caso o destino ofereça esse recurso.

7. Resolva registros não correspondidos ou alterados

Analise as linhas rejeitadas, os avisos de importação e os registros classificados de outra forma pelo destino. A ausência de um ID de transação pode impedir a correspondência; um campo de taxa em branco pode ser válido para um registro, mas não para outro. Só corrija o lançamento no destino ou o arquivo de importação de trabalho depois de conferir os dados originais.

Procure mudanças de fuso horário e de categoria das transações. Se um registro aparecer em um dia próximo, compare o horário exato e o identificador antes de considerá-lo ausente. Se uma recompensa aparecer como depósito comum, confira se o destino oferece uma categoria mais adequada e se alterá-la afeta os relatórios.

Mantenha um registro da migração com o nome do arquivo, a data da importação, os erros encontrados e as correções feitas. Por exemplo, anote que uma linha foi atribuída à carteira errada porque a exportação de origem não incluía a etiqueta da carteira. Esse histórico de alterações facilita revisões futuras e ajuda a explicar por que os dados do destino diferem do arquivo original intacto.

8. Confirme a migração antes de abandonar a configuração antiga

Não desconecte o rastreador de origem assim que a importação terminar. Primeiro, confirme que o período desejado está completo, que todas as carteiras e contas de corretoras estão representadas e que as observações e etiquetas importantes foram transferidas ou salvas separadamente. Confira novamente os registros usados no teste de amostra, além de quaisquer linhas que tenham gerado avisos de importação.

Salve os arquivos finais de importação e os resultados da reconciliação junto com as exportações originais. Se tiver feito correções, guarde tanto o arquivo intacto quanto a versão de trabalho corrigida, com nomes claros. Assim, você terá um histórico que liga o registro de origem ao lançamento de destino, caso precise investigar uma divergência meses depois.

Só depois dessas verificações decida se deve desconectar ou parar de usar o rastreador antigo. Se o serviço permitir, você pode manter o acesso somente para consulta por algum tempo. Se encerrar a conta, confirme que salvou os registros necessários e que as principais transações, saldos e observações estão disponíveis para consulta no destino.

Se ainda estiver avaliando como migrar transações entre rastreadores de criptomoedas, use esta sequência como referência: preserve a origem, teste a importação, reconcilie os resultados e só então encerre a configuração antiga.