Tax platforms can connect to your Kraken account using an API key. This lets them import your balances, trade history, and ledger history to help you calculate your crypto taxes, without you sharing your login details. This guide explains what an API is, how to choose the right permissions, and how to connect popular tax platforms.
Uma Interface de Programação de Aplicações (API) é uma forma de diferentes serviços (neste caso, bolsas e serviços fiscais) interagirem entre si.
Por vezes, os serviços podem comunicar livremente usando dados publicamente disponíveis via API, no entanto, quando se trata de consultar as informações necessárias para impostos (como os seus saldos de conta, histórico de transações, etc.), as coisas tornam-se mais complexas, porque estas informações são protegidas pelo seu nome de utilizador/palavra-passe/2FA (que você nunca deve partilhar com ninguém).
Usar uma API para ligar a sua plataforma fiscal à sua conta Kraken é uma forma eficiente de permitir o acesso aos dados da sua conta sem partilhar as suas informações de início de sessão.
Para ligar a sua plataforma fiscal à sua conta Kraken, precisa de dar à plataforma fiscal acesso às informações da sua conta através de uma chave API.
Você não quer que terceiros saibam o seu nome de utilizador/palavra-passe/2FA, e também não quer que eles negociem ou levantem fundos da sua conta, por isso é usada uma chave API com as permissões adequadas.
As permissões que você dá à chave API definirão os limites do que a outra plataforma pode ver e fazer na sua conta.
De um modo geral, as permissões necessárias para um software fiscal calcular as suas mais-valias/menos-valias são as seguintes:
Consultar fundos, Consultar ordens e transações fechadas (opcional para algumas bolsas), Consultar entradas de livro-razão e Exportar dados.
Estas são conhecidas como permissões de apenas leitura, o que significa que permitem que a outra plataforma veja os fundos na sua conta, bem como as transações no seu histórico de conta, mas não lhes permitem fazer quaisquer alterações na sua conta (nenhuma nova transação e nenhuma nova transação de financiamento).
Vamos ver como isto se apresenta na Kraken PRO:
Para saber como criar uma API na Kraken, consulte abaixo.
Fundos:
Consultar: isto permite que a chave API visualize o saldo da conta e os registos de financiamento (depósitos e levantamentos históricos) na conta.
Ordens e transações:
Consultar ordens e transações fechadas: isto permite que a chave API veja as ordens e transações fechadas na conta (isto é usado para ajudar a determinar lucro/prejuízo).
Dados:
Consultar Entradas de Livro-Razão: isto permite que a chave API visualize o livro-razão da conta, que é um registo de todas as transações de negociação/financiamento passadas.
Exportar Dados: isto permite que a chave API exporte todos os dados mencionados acima, incluindo o seu histórico de negociação e livro-razão da conta (geralmente em formato CSV).
Para mais informações sobre como ligar a sua conta Kraken à Koinly, visite:
Comece por selecionar o seu país de residência
Em seguida, clique em Adicionar Carteira e selecione Kraken
Para usar o método de 'Sincronização Automática' da API, insira a sua Chave Pública e Privada obtidas em Kraken.com e clique em Adicionar Kraken.
Para carregar manualmente o seu ficheiro CSV, por favor, reformate os seus dados usando o guia CSV do CoinTracker e carregue-os no modelo CSV do CoinTracker.
Uma vez concluído, arraste e largue o modelo CSV do CoinTracker preenchido na área de carregamento designada.
Se precisar de mais assistência, por favor, consulte o guia passo a passo do CoinTracker abaixo.
Na página principal, defina as suas configurações básicas
Clique em próximo passo, seguido de 'ver mais opções'
Selecione Kraken da lista de carteiras/bolsas
Por favor, copie e cole as suas chaves Pública e Privada da Kraken nos campos Chave API e Chave Secreta e clique em "Ligar Bolsa"
Na página principal, por favor, selecione 'Inserir Moedas' e procure e selecione Kraken (Não confundir com Kraken Futures)
Desça até 'Criar um novo Trabalho Kraken automático' e cole a Chave API, bem como a sua Chave Privada API (secreta), depois clique em 'Guardar Este Trabalho Kraken'
Para carregar manualmente o seu ficheiro CSV, clique no separador 'Importar CSV', depois arraste e largue o seu ficheiro CSV e clique em 'Continuar a Importar'.
Por fim, por favor, clique em 'Iniciar Importação'
Se precisar de mais assistência, por favor, consulte o guia passo a passo do CoinTracking abaixo:
Para um guia completo sobre como carregar dados da Kraken para o Crypto Tax Calculator (CTC), visite o nosso artigo de suporte: Ligar ao Crypto Tax Calculator
Na página do painel de controlo, selecione o botão + Integração no canto superior direito:
Em seguida, selecione Kraken quando for solicitado a selecionar uma Carteira.
Está visivelmente listado em Integrações Mais Populares.
Em seguida, por favor, selecione Kraken (para Dados API Spot) ou Kraken Futures (para Dados Futures).
*Por favor, note que as Chaves API do Kraken Futures são separadas e distintas das Chaves API Kraken SPOT e não podem ser usadas de forma intercambiável*
Por favor, copie a sua Chave API e a sua Chave Privada API da sua conta Kraken e cole-as nos campos correspondentes no site da Blockpit e clique em Continuar.
Após clicar em 'Continuar', o processo de sincronização dos saldos da sua conta e do histórico de transações começará. Isto pode demorar alguns segundos ou minutos, dependendo da duração do seu histórico de conta.
Os seus saldos da Kraken (e Kraken Futures) serão mostrados em Integrações no Painel de Controlo, onde pode sincronizar os dados a qualquer momento, ou tê-los automaticamente sincronizados a cada 24 horas com uma licença Blockpit ativa.
Se precisar de mais assistência, por favor, consulte o guia passo a passo da Blockpit abaixo.
Recap is a crypto tax calculator for UK taxpayers and their accountants. It calculates your Capital Gains Tax using HMRC’s same day, 30-day and Section 104 matching rules, and produces the figures you need for your Self Assessment return.
When you create your Kraken API key for Recap, select Query (funds), Query open orders & trades, Query closed orders & trades, Query ledger entries and Export data.
From the Accounts page, select the Add account button at the top right.
Next, select Connect to Exchange API and click Next.
Select Kraken (for spot data) or Kraken Futures (for futures data) and click Next, then give the account a name and click Next again.
Please note that Kraken Futures API keys are separate and distinct from Kraken Spot API keys and cannot be used interchangeably.
Copy your API Key and your API Private Key from your Kraken account, paste them into the API Key and API Secret fields, and click Next.
Recap will then import your Kraken history, including staking and Earn rewards, and keep it in sync. This can take a few minutes, depending on how long your account history is. Once it has finished, open Tax in Recap to see your capital gains and income for each UK tax year, and download your HMRC reports.
If you need further assistance, please take a look at the Recap step by step guide below.
Estou a receber um erro de chave inválida ao adicionar a minha Chave Pública e Privada a um software de terceiros.
Se lhe for apresentado este erro, primeiro certifique-se de que está a copiar as chaves privada e pública corretamente. Se o estiver a fazer e continuar a receber o erro de chave inválida, crie uma nova chave com as permissões corretas e tente adicioná-la novamente.
Os meus saldos de Earn/Staked não estão a aparecer.
Alguns softwares fiscais de terceiros não conseguem importar os nossos saldos de ativos em staking corretamente via API. Isto pode ser geralmente resolvido exportando o seu histórico de conta e carregando-o manualmente para o site de terceiros. Para saber como exportar manualmente o seu histórico de conta, clique abaixo.
Algumas das minhas transações estão em falta.
As funções de compra/venda instantânea não são registadas no histórico de transações da conta, no entanto, podem ser vistas no Livro de Razão da conta. Algumas plataformas de terceiros não conseguem interpretar corretamente as entradas de compra/venda no livro de razão da conta. Se for este o caso, exporte manualmente o seu histórico de conta e carregue o ficheiro para a plataforma de terceiros que está a utilizar.
Descarreguei manualmente o meu histórico de conta, mas não compreendo o que significam os símbolos.
O seu histórico de conta completo é composto por duas partes, nomeadamente o seu Livro de Razão e as suas Transaçõ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 seu Livro de Razão da conta e o histórico de Transações, vamos ver como interpretar cada um.
É seguro fornecer as minhas chaves API a um software de terceiros?
Enquanto um site/aplicação de terceiros exigir as suas chaves API privadas da Kraken, podem existir potenciais problemas de segurança, mas desde que crie uma chave API específica com permissões mínimas, por exemplo, apenas para ler o seu saldo e/ou livro de razão, não há risco para os seus fundos ou segurança em geral. Por esta razão, é aconselhável conceder permissões de apenas leitura e criar uma chave API específica com as referidas permissões para partilhar com o seu software de terceiros de confiança.
Aviso Legal: A Kraken não fornece aconselhamento fiscal. Dependendo do quadro regulamentar do seu país, poderá ter de pagar impostos sobre mais-valias resultantes da negociação de ativos digitais ou sobre o valor da sua carteira de ativos digitais. Poderá também ter de pagar impostos sobre outros rendimentos que obtenha, como recompensas ou empréstimos das suas criptomoedas. O quadro regulamentar para a tributação de criptomoedas difere de país para país. Os EUA não emitiram orientações específicas sobre a tributação de recompensas para residentes fiscais dos EUA. Aconselhamos vivamente que contacte um consultor fiscal pessoal para obter mais informações sobre as suas circunstâncias fiscais pessoais.