Mensagens de erro da API

Erros de permissão negada são retornados quando o cliente da API está tentando uma tarefa para a qual a chave da API não tem permissão. Por exemplo, se um cliente da API tentasse recuperar o saldo da conta usando uma chave da API configurada para permitir acesso à negociação, mas não acesso ao gerenciamento da conta, o erro de permissão negada seria retornado. Você pode revisar suas chaves da API e suas configurações (como suas permissões) através da guia Configurações -> API do gerenciamento da conta. Você precisaria garantir que as chaves da API usadas por seus aplicativos de terceiros tenham todas as configurações e permissões que seus aplicativos exigem.

Este erro é retornado quando a chave da API usada para a chamada está expirada ou desativada. Por favor, revise a chave da API na guia Configurações -> API do gerenciamento da conta ou gere uma nova e atualize seu aplicativo.

Você pode obter a lista completa de nossos pares de ativos da chamada pública AssetPairs e procurar o nome do par como a entrada dos cabeçalhos Json ou pelo parâmetro "altname": https://api.kraken.com/0/public/AssetPairs

Este erro é retornado quando um método é chamado sem os parâmetros necessários. Por exemplo, chamar o método QueryOrders sem especificar um ID de transação (txid) válido resultaria no erro de argumentos inválidos. Chamar um método com parâmetros desnecessários ainda não retornaria o erro de argumentos inválidos, pois os parâmetros desnecessários seriam simplesmente ignorados.

Erros de assinatura inválida ocorrem se sua chave de API ou segredo de API estiverem escritos incorretamente em seu programa ou porque os dados POST usados na autenticação e os dados POST enviados para a API não correspondem. Para referência adicional, o seguinte é um exemplo de código Python para implementar o algoritmo de assinatura da API. A chave pública de API apropriada deve ser copiada e colada do gerenciamento da conta, e o método da API e os dados POST devem ser atualizados adequadamente. O valor de saída pode ser usado diretamente como o valor para o cabeçalho HTTP API-Sign. #!/usr/bin/env python

# Importar bibliotecas Python necessárias
import time
import base64
import hashlib
import hmac

# Decodificar chave privada da API do formato base64 exibido no gerenciamento da conta
api_secret = base64.b64decode("nmlrD83t1J+yVWKUBx9vD6j26C5zhC11tFfXpN+Ww+8oOVuGgse5AeADcvl95jYaD+UAi3D5CrVfFr8GfQ7zhA==")

# Variáveis (método da API, nonce e dados POST)
api_path = "/0/private/TradeBalance"
api_nonce = str(int(time.time()*1000))
api_post = "nonce=" + api_nonce + "&asset=xxbt"

# Algoritmos de hash criptográfico
api_sha256 = hashlib.sha256(api_nonce + api_post).digest()
api_hmac = hmac.new(api_secret, api_path + api_sha256, hashlib.sha512)

# Codificar assinatura para o formato base64 usado no valor API-Sign
api_signature = base64.b64encode(api_hmac.digest())

# Assinatura de autenticação da API para uso no cabeçalho HTTP API-Sign
print(api_signature)O SHA256 é calculado usando o próprio valor nonce e os dados POST para o método da API, e os DADOS POST são compostos pelos pares nome/valor para o nonce (novamente) e os parâmetros do método da API. Um exemplo dos dados que devem ser passados para o SHA256 para o método TradeBalance seria o seguinte:SHA256 = SHA256 de "1541933977000nonce=1541933977000&asset=xxbt"O valor da string que é passado para o SHA256 não deve conter nenhum valor nulo adicional (\0) e o valor da string não deve ser codificado como base64 ou hexadecimal (ou seja, o valor da string deve ser uma string de texto simples).O caminho URI é a URL completa do método da API, exceto pelo prefixo "https://api.kraken.com", então o caminho URI do método TradeBalance (por exemplo) seria o valor da string "/0/private/TradeBalance" sem quaisquer valores nulos adicionais.O HMAC SHA512 é calculado usando o caminho URI e o digest SHA256 calculado anteriormente, com a chave privada da API decodificada em base64 como a chave HMAC. Um exemplo dos dados que devem ser passados para o HMAC seria o seguinte:HMAC SHA512 usando chave privada decodificada em base64 = HMAC de "/0/private/TradeBalanceSHA256"Os cabeçalhos HTTP API-Key e API-Sign são os únicos dois cabeçalhos HTTP personalizados necessários. O cabeçalho API-Key é uma duplicata exata da chave pública da API do gerenciamento da conta. O cabeçalho API-Sign é o digest HMAC SHA512 codificado usando base64.

Você pode encontrar mais informações sobre este erro aqui:https://support.kraken.com/hc/en-us/articles/360001148063E mais sobre Nonce e Janela Nonce aqui:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Erros de sessão inválida são retornados via API WebSocket quando uma tentativa é feita para assinar um feed autenticado (privado) usando um token de autenticação que não é mais válido (já expirou, por exemplo).

A solução é simplesmente solicitar um novo token de autenticação através do endpoint GetWebSocketsToken da API REST e usar o novo token para todas as solicitações de assinatura autenticadas (privadas) subsequentes.

Um erro de solicitação inválida indica que há algo incorreto na solicitação HTTP subjacente (não na solicitação subsequente da API), como URLs incompatíveis entre REST/WebSocket, ou não incluir os dados POST HTTP corretamente:

% curl --data "" https://api.kraken.com/0/private/GetWebSocketsToken

{"error":["EAPI:Bad request"]}

Este erro é retornado quando o endpoint sendo chamado não é um endpoint válido.

Você excedeu o limite de taxa da API.

Embora adicionar e cancelar ordens não conte para os nossos limites padrão de contador da API, essas operações têm seu próprio contador de adição e cancelamento de ordens. Este contador funciona de forma que, quanto mais tempo as ordens permanecem no livro de ordens, mais ordens os clientes conseguem adicionar ou cancelar.

Mensagens de erro de bloqueio temporário podem ocorrer se você tiver muitas chamadas de API falhas ou muitos erros de nonce inválido em um curto período de tempo ou assinaturas inválidas. Mesmo que essas chamadas retornem um erro, esse erro ainda conta para seus limites de API e pode resultar em um bloqueio temporário.

Os bloqueios temporários duram aproximadamente 15 minutos. Após receber o erro de bloqueio temporário, aguarde 15 minutos antes de enviar qualquer nova solicitação de API. Se você estiver acionando vários erros de nonce inválido, aumente a janela de nonce, pois isso pode ajudar a reduzir a frequência com que esses erros ocorrerão. Tente também reduzir a frequência de suas chamadas de API privadas.

A abertura de novas posições à vista com margem foi temporariamente suspensa para manutenção do motor de negociação. O recurso estará de volta em breve e você pode acompanhar as atualizações em status.kraken.com.

Outras razões podem ser que as posições à vista com margem não estão atualmente disponíveis para clientes residentes em certos países.

Na Kraken, você não pode abrir uma posição longa e curta para o mesmo par.

Se desejar abrir uma posição longa e curta para a mesma moeda, escolha pares de negociação diferentes com a mesma moeda como moeda base ou de cotação. Ex: short XBT/USD, long XBT/EUR.

Este erro ocorre quando você excedeu os limites de margem permitida para o seu nível de verificação atual. Os limites de margem permitida para cada moeda variam com base no seu nível de verificação atual.

Temos fundos limitados disponíveis para extensões de margem. A mensagem "margem insuficiente" indica que estamos sem fundos no pool de margem aplicável no momento. Isso pode mudar a qualquer momento. Você pode conseguir fazer seu pedido segundos ou minutos depois, mas pedidos de alto volume e pedidos feitos durante horários de alto volume podem levar mais tempo. Pedimos desculpas por qualquer inconveniente.

Este erro ocorre quando não há Margem Livre suficiente para abrir uma nova posição na conta ou se a tentativa atual de abrir uma posição resultaria na Margem Livre da conta caindo abaixo de 100%.

Você não tem fundos disponíveis para fazer este pedido. Por favor, revise suas posições e pedidos abertos para itens que possam estar retendo seus fundos.

Você não atingiu o volume mínimo de pedido para este ativo.

Você excedeu o número máximo de pedidos abertos disponíveis para sua conta.

Esses limites são baseados no seu nível de verificação. Por favor, feche alguns de seus pedidos abertos ou verifique sua conta para um nível superior.

Você excedeu o número máximo de posições abertas disponíveis para sua conta.

Esses limites são baseados no seu nível de verificação. Por favor, feche ou liquide algumas ou todas as suas posições abertas ou verifique sua conta para um nível superior, se possível.

Foi feita uma tentativa de editar um pedido existente (aberto), mas as modificações não puderam ser concluídas com sucesso. As possíveis razões incluem fundos insuficientes para o novo pedido, alguns cenários de preenchimento parcial e alguns pedidos alavancados.

O novo volume é menor do que o volume já executado/preenchido.

O tamanho da ordem excedeu o limite de tamanho da posição de margem do par de negociação.

O volume de exibição não atingiu o volume mínimo da ordem.

O volume de exibição deve ser menor que o volume da ordem.

Ordens iceberg não são compatíveis com nenhum outro tipo de ordem além de uma ordem limite.

Cada criptomoeda tem um máximo de 5 novos endereços de depósito (não utilizados), após o que qualquer tentativa de criar um 6º novo endereço retornará um erro.

Este erro é retornado sempre que os endpoints de financiamento são chamados com um parâmetro "method" inválido ou ausente. 

O parâmetro de entrada "key" não corresponde à descrição do endereço definida no gerenciamento da conta (via Financiamento -> Retirada).

Os valores mínimos de retirada por moeda variam e qualquer tentativa de retirada abaixo do mínimo resultaria neste erro.

Este é um erro genérico que indica que uma solicitação de financiamento não pôde ser concluída (por exemplo, clientes de certos locais que tentam fazer solicitações de staking on-chain causariam este erro).

A retirada solicitada não pôde ser concluída porque o endereço de destino está faltando as informações necessárias do beneficiário/destinatário (observe que isso atualmente se aplica apenas a retiradas selecionadas de contas canadenses).

Os erros de serviço que você está enfrentando devem ser apenas temporários. Você pode querer reenviar suas solicitações se elas falharam. Estaremos monitorando os problemas e atualizaremos nossa página:

https://status.kraken.com/

Quando enfrentamos problemas de degradação da API, isso pode se traduzir em problemas para a Kraken na forma de mensagens de serviço indisponível e interrupções do site.

Este problema está relacionado à segurança da sua conta, que pode ter sido comprometida. Por favor, altere sua senha e Autenticação de Dois Fatores e entre em contato com nossa Central de Suporte.

Este erro ocorre quando um sinalizador ou parâmetro de entrada é desativado temporária ou permanentemente. O erro deve vir de uma das entradas passadas; entre em contato com nosso suporte enviando um registro com as informações completas usadas para a chamada que gerou o erro.

Esses erros 5xx e 10xx não são, na verdade, erros da API, mas sim erros do servidor web do Cloudflare.

Os erros da API são sempre retornados no formato JSON, como “error”:[“ErrorType:ErrorMessage”], então, sempre que um erro em um formato diferente for recebido (como um código de status HTTP 520, 504, 502, 1020, etc.), a solução provisória é tentar a chamada da API novamente logo depois e, esperançosamente, a chamada será bem-sucedida.