Como usar nossa API para impostos

Última atualização: 31 de mar. de 2025

Uma Interface de Programação de Aplicativos é uma forma de diferentes serviços (corretoras e serviços fiscais, neste caso) interagirem entre si.

Às vezes, os serviços podem se comunicar livremente usando dados publicamente disponíveis via API; no entanto, quando se trata de consultar as informações necessárias para impostos (como saldos de sua conta, histórico de negociações, etc.), as coisas ficam mais complexas, porque essas informações são protegidas por seu nome de usuário/senha/2FA (que você nunca deve compartilhar com ninguém).

Usar uma API para conectar sua plataforma fiscal à sua conta Kraken é uma maneira eficiente de permitir o acesso aos dados de sua conta sem compartilhar suas informações de login.

Para conectar sua plataforma fiscal à sua conta Kraken, você precisa conceder à plataforma fiscal acesso às informações de sua conta por meio de uma chave de API.

Você não quer que terceiros saibam seu nome de usuário/senha/2FA, e também não quer que eles negociem ou retirem fundos de sua conta, então uma chave de API com as permissões apropriadas é usada em vez disso.

As permissões que você concede à chave de API definirão os limites do que a outra plataforma pode ver e fazer em sua conta.

De modo geral, as permissões necessárias para um software fiscal calcular seus ganhos/perdas de capital são as seguintes:

Consultar fundos, Consultar ordens e negociações fechadas (opcional para algumas corretoras), Consultar entradas de livro-razão e Exportar dados.

Estas são conhecidas como permissões de somente leitura, o que significa que elas permitem que a outra plataforma veja os fundos em sua conta, bem como as transações em seu histórico de conta, mas não permitem que façam quaisquer alterações em sua conta (sem novas negociações e sem novas transações de financiamento).

Vamos ver como isso se parece no Kraken PRO:

Kraken PRO

Para saber como criar uma API no Kraken, consulte abaixo.

Fundos:

Consultar: isso permite que a chave de API visualize o saldo da conta e os registros de financiamento (depósitos e saques históricos) na conta.

Ordens e negociações:

Consultar ordens e negociações fechadas: isso permite que a chave de API veja as ordens e negociações fechadas na conta (isso é usado para ajudar a determinar lucro/prejuízo).

Dados:

Consultar entradas de livro-razão: isso permite que a chave de API visualize o livro-razão da conta, que é um registro de todas as transações passadas de negociação/financiamento.

Exportar dados: isso permite que a chave de API exporte todos os dados mencionados acima, incluindo seu histórico de negociações e livro-razão da conta (geralmente em formato CSV).

Para mais informações sobre como conectar sua conta Kraken ao Koinly, visite:

Comece selecionando seu país de residência

1

Em seguida, clique em Adicionar Carteira e selecione Kraken

2

Para usar o método de 'Sincronização Automática' da API, insira sua Chave Pública e Privada obtidas em Kraken.com e clique em Adicionar Kraken.

3

3

4

Para carregar manualmente seu arquivo CSV, por favor, reformate seus dados usando o guia CSV do CoinTracker e carregue-o no modelo CSV do CoinTracker.

Uma vez concluído, arraste e solte o modelo CSV do CoinTracker preenchido na área de upload designada.

5

Se precisar de mais assistência, consulte o guia passo a passo do CoinTracker abaixo.

Na página principal, defina suas configurações básicas

1

Clique em próximo passo, seguido por 'ver mais opções'

2

Selecione Kraken na lista de carteiras/corretoras

4

5

Copie e cole suas chaves Pública e Privada da Kraken nos campos Chave de API e Chave Secreta e clique em "Conectar Corretora"

4

Na página principal, selecione 'Inserir Moedas' e procure e selecione Kraken (Não confundir com Kraken Futures)

Select Exchange/Wallet

Role para baixo até 'Criar um novo trabalho automático da Kraken' e cole a Chave de API, bem como sua Chave Privada de API (secreta), então clique em 'Salvar Este Trabalho da Kraken'

Input Public/Private Keys

Para carregar manualmente seu arquivo CSV, clique na 'aba de importação CSV', então arraste e solte seu arquivo CSV e clique em 'Continuar para Importar'.

Manually Upload CSV file

Por fim, clique em 'Iniciar Importação'

Manually upload CSV file

Successfully uploaded CSV file

Se precisar de mais assistência, consulte o guia passo a passo do CoinTracking abaixo:

Para um guia completo sobre como carregar dados da Kraken no Crypto Tax Calculator (CTC), visite nosso artigo de suporte:

Na página do painel, selecione o botão + Integração no canto superior direito:

Blockpit

Em seguida, selecione Kraken quando solicitado a selecionar uma Carteira.

Ele está visivelmente listado em Integrações Mais Populares.

Em seguida, selecione Kraken (para Dados da API Spot) ou Kraken Futures (para Dados de Futuros).

*Observe que as Chaves de API do Kraken Futures são separadas e distintas das Chaves de API do Kraken SPOT e não podem ser usadas de forma intercambiável*

Blockpit

Blockpit 3

Copie sua Chave de API e sua Chave Privada de API da sua conta Kraken e cole-as nos campos correspondentes no site da Blockpit e clique em Continuar.

Blockpit 3

Após clicar em 'Continuar', o processo de sincronização dos saldos da sua conta e do histórico de transações será iniciado. Isso pode levar alguns segundos ou minutos, dependendo da duração do histórico da sua conta.

Blockpit 4

Seus saldos Kraken (e Kraken Futures) serão exibidos em Integrações no Painel, onde você pode sincronizar os dados a qualquer momento, ou tê-los sincronizados automaticamente a cada 24 horas com uma licença Blockpit ativa.

Se precisar de mais assistência, consulte o guia passo a passo da Blockpit abaixo.

  • Estou recebendo um erro de chave inválida ao adicionar minha Chave Pública e Privada a um software de terceiros.

    Se este erro for apresentado, primeiro certifique-se de que está copiando as chaves privada e pública corretamente. Se estiver fazendo isso e ainda receber o erro de chave inválida, crie uma nova chave com as permissões corretas e tente adicioná-la novamente.

  • Meus saldos de Ganhos/Staking não estão aparecendo.

    Alguns softwares fiscais de terceiros não conseguem importar nossos saldos de ativos em staking corretamente via API. Isso geralmente pode ser corrigido exportando o histórico da sua conta e carregando-o manualmente para o site de terceiros. Para saber como exportar manualmente o histórico da sua conta, clique abaixo.

  • Algumas das minhas transações estão faltando.

    As funções de compra/venda instantânea não são registradas no histórico de negociações da conta, mas podem ser vistas no Livro-Razão da conta. Algumas plataformas de terceiros não conseguem interpretar corretamente as entradas de compra/venda no livro-razão da conta. Se este for o caso, exporte manualmente o histórico da sua conta e carregue o arquivo para a plataforma de terceiros que você está usando.

  • Baixei manualmente o histórico da minha conta, mas não entendo o que os símbolos significam.

    Seu histórico completo de conta é composto por duas partes, a saber, seu Livro-Razão e suas Negociações. Primeiro, vamos aprender um pouco sobre as diferenças entre os dois.

    Agora que temos uma boa compreensão das diferenças entre o Livro-Razão da sua conta e o histórico de Negociações, vamos ver como interpretar cada um.

  • É seguro fornecer minhas chaves de API a um software de terceiros?

    Enquanto um site/aplicativo de terceiros exigir suas chaves de API privadas da Kraken, pode haver problemas potenciais de segurança, mas desde que você crie uma chave de API específica com permissões mínimas, por exemplo, apenas para ler seu saldo e/ou livro-razão, não há risco para seus fundos ou segurança em geral. Por esta razão, é aconselhável conceder permissões somente leitura e criar uma chave de API específica com essas permissões para compartilhar com seu software de terceiros confiável.


Precisa de mais ajuda?