Como usar nossa API para impostos

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

Uma Interface de Programação de Aplicativos (API) é 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 dar à plataforma fiscal acesso às informações da sua conta por meio de uma chave 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 saquem de sua conta, então uma chave API com as permissões apropriadas é usada em vez disso.

As permissões que você concede à chave 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 do livro-razão e Exportar dados.

Estas são conhecidas como permissões 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 ela faça quaisquer alterações em sua conta (sem novas negociações e sem novas transações de financiamento).

Vamos ver como isso se parece na Kraken PRO:

Kraken PRO

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

Fundos:

Consultar: isso permite que a chave 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 API veja as ordens e negociações fechadas na conta (isso é usado para ajudar a determinar lucro/prejuízo).

Dados:

Consultar Entradas do Livro-Razão: isso permite que a chave 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 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 à 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 adquiridas em Kraken.com e clique em Adicionar Kraken.

3

3

4

Para carregar manualmente seu arquivo CSV, re-formate seus dados usando o guia CSV do CoinTracker e carregue-os no modelo CSV do CoinTracker.

Assim que isso for 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 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 Kraken' e cole a Chave API, bem como sua Chave Privada API (secreta), então clique em 'Salvar Este Trabalho Kraken'

Input Public/Private Keys

Para carregar manualmente seu arquivo CSV, clique na aba 'Importar 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 for 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 Futures).

*Observe que as Chaves de API do Kraken Futures são separadas e distintas das Chaves de API SPOT do Kraken 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 você se deparar com este erro, primeiro certifique-se de que está copiando as chaves privada e pública corretamente. Se você 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 Earn/Staked não estão aparecendo.

    Alguns softwares fiscais de terceiros não conseguem importar nossos saldos de ativos staked 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 Ledger da conta. Algumas plataformas de terceiros não conseguem interpretar corretamente as entradas de compra/venda no Ledger da conta. Se for esse 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.

    O histórico completo da sua conta é composto por duas partes, a saber, seu Ledger 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 Ledger da sua conta e o histórico de Negociações, vamos dar uma olhada em 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 Ledger, não há risco para seus fundos ou segurança em geral. Por esse motivo, é 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?