Perguntas Frequentes da API Avançada

Última atualização: 25 de nov. de 2025

Valores de status possíveis para transações de depósito/saque

Usando os endpoints de financiamento da API REST, os clientes podem depositar/sacar fundos de/para suas contas Kraken e solicitar o status em tempo real de uma transação de depósito/saque.

Depósitos/saques passam por várias etapas entre a solicitação inicial e a conclusão da transação, portanto, os endpoints de financiamento retornarão um valor de status diferente dependendo de quando são chamados.

Observe que os valores de status vieram originalmente das páginas 16/17 do documento Internet Financial Exchange Protocol (IFEX), mas os valores foram ligeiramente modificados para serem mais adequados para transações de cripto (nem todos os valores de status possíveis são usados, por exemplo).

Depósitos

Os possíveis valores de status para transações de depósito são os seguintes:

•
Liquidado = O depósito foi recebido, mas ainda precisa de confirmações adicionais na blockchain.
•
Sucesso = O depósito atingiu o número necessário de confirmações na blockchain.
•
Falha = O depósito falhou (por uma ou mais razões diversas).

A seguir estão alguns exemplos de como os valores de status acima apareceriam nas respostas do endpoint DepositStatus:

Status Liquidado:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Status Sucesso:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

Saques

Os possíveis valores de status para transações de saque são os seguintes:

•
Inicial = A solicitação de saque foi recebida e está sendo verificada quanto à validade (quaisquer restrições de financiamento na conta, etc.).
•
Pendente = O saque está aguardando processamento pelo nosso gateway de financiamento.
•
Liquidado = O saque foi enviado para a blockchain (neste ponto, o ID da transação da blockchain estaria disponível).
•
Sucesso = A transação de saque tem pelo menos 1 confirmação na blockchain.
•
Em espera = O saque foi retido e precisa ser verificado manualmente pela nossa equipe de financiamento.
•
Falha = O saque falhou (por uma ou mais razões diversas).

A seguir estão alguns exemplos de como os valores de status acima apareceriam nas respostas do endpoint WithdrawStatus:

Status Inicial:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Status Pendente:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Status Liquidado:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Status Sucesso:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Status Falha:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

Informações adicionais sobre depósitos/saques estão disponíveis em nossas páginas de suporte de financiamento em dinheiro e financiamento em criptomoedas.

Como recuperar o histórico de tempo e vendas (histórico de negociações) usando o endpoint Trades da API REST

O endpoint OHLC da API REST fornece apenas uma quantidade limitada de dados históricos, especificamente 720 pontos de dados do intervalo solicitado. Por exemplo, solicitar dados OHLC em intervalos de 1 minuto retornará os 720 minutos mais recentes (12 horas) de dados.

Para aplicações que exigem dados OHLC ou de tick adicionais, é possível recuperar todo o histórico de negociação de nossos mercados (o histórico de tempo e vendas) através do endpoint Trades da API REST. O OHLC para qualquer período de tempo e qualquer intervalo pode então ser criado a partir dos dados históricos de tempo e vendas.

O endpoint Trades aceita um parâmetro opcional chamado since, que especifica a data/hora de início dos dados. O valor de since é um timestamp UNIX com resolução de nanossegundos (um timestamp UNIX padrão em segundos com 9 dígitos adicionais).

Por exemplo, uma chamada para o endpoint Trades como https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 retornaria o histórico de tempo e vendas para XBT/USD a partir de 1º de junho de 2019 às 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Chamadas subsequentes ao endpoint Trades devem substituir o valor do parâmetro since pelo valor do parâmetro last dos resultados da chamada anterior, como https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Usar o valor especial since de 0 (zero) retornaria o histórico de tempo e vendas desde o início do mercado (começando com a primeira negociação).

Como colocar, visualizar e cancelar ordens usando uma referência de usuário

Uma referência de usuário é um ID de ordem fornecido pelo cliente que pode ser usado no lugar do ID de ordem real (fornecido pela API) para algumas tarefas de gerenciamento de ordens (notavelmente o cancelamento de ordens).

As referências de usuário são implementadas para serem o mais flexíveis possível e, portanto, podem ser usadas de várias maneiras, incluindo:

•
como um ID exclusivo (onde cada ordem tem uma referência de usuário diferente),
•
para agrupar ordens relacionadas (como agrupar ordens com diferentes níveis de alavancagem),
•
ou como um ID de backup caso o ID da ordem real não seja conhecido.

Uma referência de usuário deve ser um valor numérico entre 1 e 2.147.483.647 (essencialmente qualquer número positivo de 32 bits) e, portanto, pode ser implementada como um contador simples, como um valor aleatório assinado de 32 bits ou mesmo como um carimbo de data/hora em segundos (embora isso falharia após 19 de janeiro de 2038 às 03:14:07 UTC).

Como colocar ordens com uma referência de usuário

As ordens podem ser colocadas com uma referência de usuário anexada chamando o endpoint AddOrder e incluindo o parâmetro userref com a referência de usuário como valor:

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

Visualizando ordens que possuem uma referência de usuário

Ordens que já possuem uma referência de usuário anexada podem ser visualizadas chamando os endpoints Open/Closed/QueryOrders e incluindo o parâmetro userref com a referência de usuário existente como o valor (neste caso, a referência de usuário atua como um filtro, exibindo apenas as ordens associadas):

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

Cancelando ordens que possuem uma referência de usuário

Ordens que já possuem uma referência de usuário anexada podem ser canceladas usando a referência de usuário, chamando o endpoint CancelOrder e usando a referência de usuário como valor txid (no lugar do valor do ID da ordem):

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

Observe que todas as ordens abertas com a mesma referência de usuário seriam canceladas, portanto, é possível fazer uma única chamada CancelOrder para cancelar várias ordens simultaneamente (conforme indicado pelo valor count de 3 na seguinte resposta):

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

Por que estou recebendo um erro 403 ao usar a API da Kraken?

Este problema pode estar relacionado ao Cloudflare:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

NOTA: A Kraken tem o "Browser Integrity Check" ativado.

Isso pode ocorrer se sua solicitação contiver cabeçalhos suspeitos. Por exemplo, sua solicitação pode estar sem um user agent ou usar um user agent não padrão; portanto, verifique os cabeçalhos da sua solicitação.

Se você não conseguir criar nenhuma solicitação padrão que nosso sistema permita, envie-nos uma cópia completa da(s) solicitação(ões) que você está tentando, incluindo seu endereço IP e todos os cabeçalhos. Essas informações nos permitiriam investigar mais a fundo.

A Kraken oferece um ambiente de teste de API?

API de Futuros

Para nossas APIs REST e WebSocket de Futuros (futures.kraken.com), oferecemos um ambiente de teste completo usando a URL da API demo-futures.kraken.com.

Ambientes de Teste REST, WebSocket e FIX

Para nossa API REST/WebSocket spot e API FIX, atualmente oferecemos um ambiente de teste para clientes qualificados. O acesso a este ambiente requer um processo de integração que pode ser iniciado contatando diretamente a equipe da API.

Testando nossa API Usando o Parâmetro de Teste Validate

Ao fazer um pedido através dos endpoints AddOrder da API REST ou addOrder da API WebSocket, o parâmetro de entrada validate pode ser usado para simular o pedido.

Chamar AddOrder/addOrder com o parâmetro validate definido como true (validate=1, validate=true, validate=anything, etc.) fará com que os detalhes do pedido sejam verificados quanto a erros, mas a resposta da API nunca incluirá um ID de pedido (que sempre seria retornado para um pedido bem-sucedido sem o parâmetro validate).

Exemplo de chamada AddOrder com o parâmetro validate (observe o ID de pedido ausente):

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

Pequenos pedidos reais e/ou pedidos com preços extremos

Para um teste abrangente da API usando o Parâmetro Validate, recomendamos fazer pedidos de mercado muito pequenos (pedidos para o tamanho mínimo do pedido), ou pedidos limite que estejam com preços muito distantes do preço de mercado atual (por exemplo, fazer um pedido limite para vender ETH/USD a US$ 800 quando o preço de mercado é US$ 200).

Testar usando pedidos reais permite que seu código API interaja com nossa API em condições do mundo real, portanto, todos os aspectos do teste serão precisos (como seus pedidos afetam o livro de ofertas, etc.).

Atualização de TLS que pode afetar suas conexões de API

Por motivos de segurança, recentemente descontinuamos o suporte para TLS 1.0 e 1.1. Se você estiver encontrando mensagens de erro de conexão SSL/TLS ao tentar se conectar à nossa API, é provável que seja devido ao uso de um desses padrões obsoletos. Você precisará modificar seu cliente API para forçar o uso de TLS 1.2/1.3 ou atualizar sua versão do .NET para 4.6 ou superior, que usa TLS 1.2/1.3 como padrão.

Calculadora de autenticação da API REST (Google Sheet)

A seguinte Planilha Google pode ser usada para calcular a assinatura de autenticação da API REST para qualquer combinação de dados de entrada:

•
Chave privada (secreta) da API
•
Endpoint da API (Balance, TradeBalance, QueryOrders, etc.)
•
Valor Nonce (consulte nossa página de suporte o que é um nonce para mais detalhes)
•
Parâmetros de entrada do endpoint (por exemplo, asset=doge)

A calculadora pode ser usada para verificar se o algoritmo de autenticação foi implementado corretamente, evitando assim problemas potenciais (notavelmente erros inesperados de chave inválida) mais tarde no ciclo de desenvolvimento.

Instruções de uso

1
Abra a calculadora de autenticação da API REST no Chrome (ou em qualquer outro navegador web recente)
2
Faça uma cópia da calculadora para o seu próprio Google Drive através do menu Arquivo -> Fazer uma cópia (você precisará fazer login na sua conta Google para esta etapa)
3
Edite os campos chave da API, endpoint da API, valor nonce e dados de entrada com sua própria chave da API e detalhes da solicitação
4
Compare a assinatura de autenticação da API calculada com o valor calculado pelo seu próprio código API (os dois valores devem corresponder exatamente)

Por razões de segurança, recomendamos usar a calculadora de autenticação com uma chave de API temporária e, em seguida, excluir a chave de API da sua conta assim que a implementação da sua assinatura de autenticação for considerada correta.

Exemplo

Preciso usar um wrapper de biblioteca de cliente?

O principal benefício de usar nossos wrappers de biblioteca de cliente é que você não precisa gastar tempo/esforço para reinventar a roda na criação de assinaturas de API, isso já é feito para você.

Se você pretende apenas fazer chamadas para métodos públicos, então você pode optar por não usar bibliotecas de cliente, pois nenhuma autenticação é necessária.

A lista de wrappers disponíveis pode ser encontrada aqui.