Como exportar relatórios da Binance
A Binance gera dois conjuntos de exports CSV, ambos suportados pelo CaixaUnica. Para a maioria dos usuários, o Transaction History é suficiente; opcionalmente, suba também o Financial Statement para enriquecer cost basis e rentabilidade.
Fonte primária — Data Download Center
| Relatório | Importador | Use quando… |
|---|---|---|
| Transaction History (toda a atividade spot + earn) | binance-tx |
Sempre. É a fonte mais completa: cobre histórico desde a criação da conta, inclui spot trades, depósitos, saques, fees, Earn subscriptions e redemptions, staking rewards, airdrops. |
| Deposit History | binance-deposit |
Subset do anterior — só use se Transaction History estiver indisponível para o seu período. |
| Withdraw History | binance-withdraw |
Idem. |
| Fiat Buy/Sell History | binance-fiat-buy |
Para compras via cartão / PIX que não apareceram corretamente no Transaction History. |
Atenção ao double-count: Transaction History já cobre depósitos e saques. Se você subir ele JUNTO com Deposit + Withdraw History, os mesmos eventos aparecem duas vezes (a deduplicação cross-schema entre esses arquivos está prevista para uma versão futura). Por enquanto, só use Tx-History sozinho.
Fonte secundária — Financial Statement (opcional, recomendado)
| Relatório | Importador | Por que importar |
|---|---|---|
Account Statement (relatório anual, por exemplo 2024.csv) |
binance-fs |
Carrega o valor em BRL que a Binance atribuiu a cada evento no momento — permite que o app calcule preço médio, custo líquido e rentabilidade que o Transaction History sozinho não consegue. |
Cobertura: o Financial Statement só vai até 2022 — operações anteriores ficam sem cost basis (mas as quantidades e a posição atual continuam corretas).
Enriquecimento automático: quando você sobe o Financial Statement depois do Transaction History (ou vice-versa), o CaixaUnica casa cada evento entre os dois exports e copia o preço em BRL pra row primária. As rows duplicadas do Financial Statement são marcadas como sombra e não contam na sua posição.
Onde gerar os arquivos na Binance
Transaction History (primário)
- Entre em binance.com.
- Carteira → Histórico de transações (link direto: Transaction History).
- Gerar relatório de extratos (canto superior direito): Generate Statements.
- Janela máxima: 12 meses por arquivo. Para histórico longo, gere um arquivo por ano e suba todos.
- Baixe o
.csv(não.xlsx).
Financial Statement (secundário)
- Conta → Relatórios ou link direto Report Center.
- Escolha Account Statement e o período (ano fechado funciona bem).
- Baixe o
.csv(o arquivo costuma ter um nome tipoAccountStatementPeriod_<id>_20240101-20241231_<hash>.csvou simplesmente2024.csv).
Importar no CaixaUnica
- Abra Importar.
- Arraste o CSV. O detector auto-classifica como
binance-tx(Tx- History) oubinance-fs(Financial Statement). - Se subir mais de um arquivo, faça um upload por vez — o enriquecimento dispara após cada import.
- Selecione a conta de carteira Binance (crie uma se ainda não existe).
- Clique em Executar.
O que esperar depois do upload
- Posição (quantidade) correta para todos os ativos, incluindo o que está alocado em produtos Earn (Flexible / Locked / Staking / ETH 2.0) — esses não contam como "movido para fora" porque ainda são seus.
- Cost basis e rentabilidade populam após o upload do Financial Statement, na janela em que ele cobre (2022+).
- Ativos liquidados (que você vendeu tudo) aparecem na seção "Vendidos" de Carteira, separados dos ativos ativos.
- Ativos sem preço no yfinance (tokens muito nichados — MONKY, EDG,
alguns airdrops, projetos descontinuados como LUNA classic) mostram
posição correta mas valor
R$ 0,00.
Problemas comuns
- Operação recente não aparece no relatório: a Binance demora algumas horas para consolidar swaps e Earn subscriptions. Espere 6h e gere o relatório de novo.
- Tickers estranhos (BTCUSDT, ETHBRL): o CaixaUnica normaliza para
o ativo base (
BTC,ETH). A moeda do par segue como moeda da transação. - Convert / Binance Convert: o relatório de Transactions já inclui essas operações como uma compra + uma venda. Não precisa de export separado.
- ETH 2.0 Staking: trata como conversão de
ETH→BETH(Beacon Chain wrapper); ambos ativos aparecem na carteira separadamente. - Earn Subscription / Redemption: tratadas como movimentos entre suas carteiras internas, não afetam a posição total. Apenas os rewards (juros) entram como ganho.
- Posição negativa em algum ativo: indica double-count (você subiu Tx + Deposit + Withdraw History do mesmo período). Resete os dados em Conta → Zona de perigo e suba apenas Transaction History.