OKX: como exportar o histórico e importar no CriptoTax pelo CSV genérico

A OKX exporta o histórico de ordens e de negociações em CSV ou PDF pelo Order Center. O CriptoTax não tem importador dedicado para ela: o caminho é o CSV genérico, com mapeamento de colunas. A OKX Brasil é uma entidade brasileira, mas os termos não dizem em que país ficam os ativos.

Vale para: conta OKX de residente no Brasil. Os passos vêm da central de ajuda da OKX, em inglês, atualizada em 05/08/2026. As telas mudam.

Local de custódia, segundo a OKX

• Entidade: a OKX diz que a OKX Brasil é uma entidade brasileira, com CNPJ 50.459.025/0001-26 e sede em São Paulo (página atualizada em 11/08/2026).
• Contratante: os Termos de Serviço, atualizados em 17/09/2026, indicam a OKX Serviços Digitais Ltda. como contratante dos residentes no Brasil que se cadastraram a partir de 15/06/2023 e dos usuários brasileiros migrados que se cadastraram antes. Para alguns produtos, os termos citam também a OKX Fintech, S.A. de C.V. (El Salvador).
• Custódia: os termos dizem que a OKX atua como plataforma de execução de ordens e de custódia de ativos digitais, que pode manter ativos com terceiros e que eles podem ficar com subcustodiantes. A OKX também escreve que a conta é custodial e que a maior parte dos ativos fica em armazenamento a frio. O país da custódia não é informado.

No CriptoTax: a OKX começa como exterior. Troque para nacional somente se você tiver documento que mostre custodiante no Brasil. A entidade ser brasileira não decide sozinha o regime: a Receita considera no exterior o ativo "custodiado ou negociado" por instituição no exterior (P&R IRPF 2026, perguntas 473 e 653). O raciocínio é o da Binance a partir de 29/10/2026.

Como exportar o histórico

No site:

1. Abra Assets, Order center e o histórico que você quer.
2. Clique em Download.
3. Escolha o instrumento e o período. Na Trading history, escolha também o fuso horário e as contas.
4. Ajuste as configurações do relatório e escolha o formato: CSV ou PDF.
5. Clique em Export.
6. Quando o arquivo ficar pronto, copie o link, envie para o e-mail ou salve uma cópia local. O link copiado vale 1 hora, então abra logo.

Limites que a OKX informa:

Escolha CSV e, na Trading history, selecione o fuso UTC quando houver essa opção, porque o CriptoTax lê datas sem fuso como UTC.

A página que lemos não descreve a exportação de depósitos e saques. Se você precisar deles, procure o histórico de fundos na sua conta.

Como juntar períodos. Exporte blocos consecutivos, sem lacuna. Se a OKX recusar o período, volte para blocos menores, como 6 meses. Dias repetidos entre dois arquivos do mesmo tipo não geram operação em dobro. Não misture Order history e Trading history para o mesmo período, porque os dois descrevem as mesmas negociações.

Como o CriptoTax importa a OKX

O CriptoTax não tem importador dedicado nem integração com a OKX. Você usa o CSV genérico:

1. Envie o CSV da OKX como "CSV genérico" (ou escolha a OKX e deixe o CriptoTax usar o leitor genérico).
2. O CriptoTax lê o cabeçalho, mostra as primeiras linhas e sugere a coluna de cada campo: data, tipo ou lado, ativo ou par, quantidade, preço, total, taxa e moeda da taxa. Ele reconhece nomes em português e em inglês.
3. Confira as sugestões e ajuste o que estiver errado. Data e quantidade são obrigatórias.
4. Importe. O CriptoTax mostra quantas linhas importou, quantas já existiam e quantas deram erro.

Cada linha precisa dizer se é compra ou venda. O leitor genérico entende tipos como buy, sell, compra, venda, swap, convert, deposit, withdraw, airdrop e staking. Se a coluna de tipo ou de lado não estiver mapeada, ou o valor dela não estiver nessa lista, a linha fica como operação a classificar, e o CriptoTax só libera o cálculo e os relatórios depois que você escolher o tipo dela em Transações. Confira essa coluna antes de importar.

Quando o par é em USDT, o CriptoTax converte o valor para reais com o preço de referência em dólar e a Ptax de venda do dia, e avisa que o valor é de referência. Quando não acha o preço, a operação fica como operação sem preço, para você informar à mão.

Exemplo de mapeamento, com colunas fictícias. Suponha um arquivo com o cabeçalho abaixo. Os nomes são ilustrativos, e o arquivo da OKX pode ter outros:

Trade time,Instrument,Side,Price,Size,Fee,Fee currency
2026-09-12 09:15:30,BTC-USDT,buy,61000,0.02,1.22,USDT

O CriptoTax sugeriria: data = Trade time, par = Instrument, lado = Side, preço = Price, quantidade = Size, taxa = Fee e moeda da taxa = Fee currency. A linha é a compra de 0,02 BTC por 1.220 USDT, com taxa de 1,22 USDT. Se o dólar de referência do dia for R$ 5,50, o valor é 1.220 × 5,50 = R$ 6.710,00.

Imposto e DeCripto

• Imposto: conta tratada como exterior segue a Lei 14.754, com 15% na declaração anual, sem DARF e sem isenção de R$ 35 mil. Veja Lei 14.754 e criptomoedas e Como declarar cripto no exterior.
• DeCripto: operações em prestadora residente no exterior entram no leiaute A quando o mês passa de R$ 35.000,00. A OKX Brasil é uma entidade brasileira, e a Receita não disse se isso dispensa o usuário. A leitura conservadora soma as operações da OKX ao limite do mês. Informar a mais não tem multa prevista, e omitir custa 1,5% do valor da operação (art. 13, II, "b"). Veja DeCripto com exchange estrangeira e Quem precisa entregar a DeCripto.

O que ainda não está definido

• País da custódia. Os termos da OKX não o informam.
• Regime de imposto das contas da OKX Brasil, nacional ou exterior.
• Quem reporta a DeCripto das contas da OKX Brasil. A OKX diz que a OKX Brasil opera de acordo com as normas do Banco Central e da Receita, e não diz que ela entrega a DeCripto pelo usuário.
• Limites de período e de exportações. A página que lemos não os informa.
• Formato real do arquivo. Os nomes de coluna do exemplo são ilustrativos.

Leia também

• Corretoras no CriptoTax
• Lei 14.754 e criptomoedas

Como o CriptoTax resolve

O CriptoTax importa o CSV da OKX pelo CSV genérico, com mapeamento de colunas, e calcula conforme o local de custódia que você indicar. Para o exterior, o resultado vai para a declaração anual. Gera os dados do GCAP quando o regime é nacional, o texto de Bens e Direitos e, no plano Premium, o arquivo da DeCripto. Operações sem preço aparecem para você informar à mão. Ele não tem importador dedicado, integração por API, leitura on-chain nem tratamento automático de DeFi e NFT para a OKX. Veja os planos.

Este texto explica a norma e não substitui a orientação de um contador sobre o seu caso.

Histórico de alterações

• 12/10/2026: revisão de fatos: o tipo de operação que o CriptoTax não reconhece fica como operação a classificar.
• 11/10/2026: primeira versão.