Utilizar a API da Kraken com um serviço de terceiros

Última atualização: 1/04/2025

A nossa API permite que serviços de terceiros (como bots de negociação, aplicações móveis e serviços de gestão de portfólio) se integrem com uma conta Kraken para que possam visualizar saldos de conta, recuperar histórico de negociações, colocar e cancelar ordens, entre outros.

Qualquer titular de conta que deseje usar um serviço de terceiros precisa apenas de criar uma chave API com a configuração apropriada e fornecer esta chave ao serviço de terceiros (muitas vezes chamado de importação de uma chave API).

Na maioria das vezes, estas integrações funcionam sem problemas, mas por vezes podem ocorrer problemas que causam resultados não intencionais ou mensagens de erro inesperadas.

Problemas com serviços de terceiros ocorrem frequentemente quando o serviço está a tentar uma tarefa para a qual a chave API não tem permissão, ou quando a autenticação de dois fatores (2FA) da chave API está a impedir o acesso por completo. Se o seu serviço de terceiros não estiver a funcionar como esperado, deve rever as suas chaves API e as suas configurações através do separador Nome de utilizador -> Definições -> API na aplicação web Kraken Pro.

pro api v2.gif


Terá de se certificar de que a chave API utilizada tem todas as configurações e permissões que o seu serviço exige, e que nenhuma autenticação de dois fatores está a impedir o acesso. Detalhes completos sobre a geração e configuração de chaves API (incluindo uma explicação das permissões) estão disponíveis na nossa página de suporte de chaves API.

Alguns serviços de terceiros (como o Crypto as a Service da Fidor) também experienciam problemas ao ligar-se a contas Kraken quando as contas são novas e não têm qualquer atividade de financiamento ou negociação. Para contas novas, algumas chamadas API retornarão uma resposta incomum, como uma resposta bem-sucedida, mas vazia, como: {"error":[]} que pode ser mal interpretada pelo serviço de terceiros, resultando num erro inesperado (como o erro de servidor 500 da Fidor).

Se o seu serviço de terceiros estiver a retornar um erro inesperado e a sua conta Kraken for nova (sem qualquer atividade de financiamento ou negociação), adicione alguns fundos à sua conta Kraken através do separador Financiamento da gestão de conta. Mesmo uma pequena quantia seria suficiente para criar alguma atividade, após o que o seu serviço de terceiros deverá começar a funcionar com sucesso.

Embora algumas aplicações de terceiros recomendem aos utilizadores que alterem a definição da janela nonce, as chaves API que têm uma definição de janela nonce invulgarmente alta podem potencialmente causar o aparecimento de um erro. A definição da janela nonce destina-se a contornar problemas de rede (como acesso não fiável à Internet), por isso, na maioria dos casos, a definição da janela nonce deve ser mantida no seu valor predefinido de 0 (zero).

Se começar a experienciar erros com as suas chaves API e serviço de terceiros, um possível resultado poderá ser que as suas chaves API ficaram corrompidas. Isto só acontece quando experienciam demasiados erros. Recomendamos que o utilizador elimine as chaves existentes e gere um novo par de chaves API com todas as permissões necessárias, e importe esta nova chave API para o serviço de terceiros.

Precisa de mais ajuda?