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:
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.
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.