Usando os endpoints de depósitos e retiradas da API REST, os clientes podem depositar/retirar fundos da conta Kraken e solicitar o status em tempo real de uma transação de depósito/retirada.

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

Observe que os valores de status vieram originalmente das páginas 16/17 do documento Protocolo de Exchange Financeiro pela Internet (IFEX), mas os valores foram ligeiramente modificados para se adaptarem às transações de criptomoeda (nem todos os valores de status possíveis são usados, por exemplo).

Os seguintes sã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 de 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"}]}

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 de 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 de 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/retiradas estão disponíveis em nossas páginas de suporte depósitos e retiradas em dinheiro e depósitos e retiradas em criptomoeda.

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 requerem dados OHLC ou de ticks adicionais, é possível recuperar todo o histórico de negociação de nossos mercados (o histórico de tempo e vendas) por meio do Endpoint de negociações da API REST. O OHLC para qualquer intervalo de tempo e qualquer período pode ser criado a partir dos dados históricos de tempo e vendas.

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

Por exemplo, uma chamada ao Endpoint de negociações 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 de negociações devem substituir o valor do parâmetro desde pelo valor do parâmetro último dos resultados da chamada anterior, como https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

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

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

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 diferentes, incluindo:

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, poderia ser implementada como um contador simples, como um valor aleatório de 32 bits com sinal ou mesmo como um timestamp em segundos (embora isso falhe após 19 de janeiro de 2038 às 3:14:07 UTC).

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 a "Verificação de integridade do navegador" habilitada.

Isso pode ocorrer se sua solicitação contiver cabeçalhos suspeitos. Por exemplo, sua solicitação pode estar sem um agente de usuário ou usar um agente de usuário fora do padrão. Portanto, verifique os cabeçalhos da sua solicitação.

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

Pequenas ordens reais e/ou ordens com preços extremos

Para um teste abrangente da API usando o Parâmetro Validate, recomendamos adicionar ordens de mercado muito pequenas (ordens para o tamanho mínimo da ordem), ou ordens limitadas que estão precificadas muito longe do preço de mercado atual (adicionar uma ordem limitada para vender ETH/USD a $ 800 quando o preço de mercado é $ 200, por exemplo).

Testar usando ordens ao vivo permite que seu código de API interaja com nossa API em condições do mundo real, portanto, cada aspecto do teste será rigoroso (como suas ordens afetam o livro de ofertas etc.).

Por razões de segurança, recentemente deixamos de oferecer suporte ao 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 da API para forçar o uso do 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.

A seguinte planilha do Google pode ser usada para calcular a Assinatura de autenticação da API REST Para qualquer combinação de dados de entrada:

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

Por motivos de segurança, recomendamos usar a calculadora de autenticação com uma chave de API temporáriae, em seguida, excluir a chave de API da sua conta assim que a implementação da assinatura de autenticação estiver correta.

O principal benefício de usar nossas bibliotecas de cliente é que você não precisa gastar tempo/esforço para reinventar a roda e criar assinaturas de API, isso já está feito para você.

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

A lista de wrappers disponíveis que você pode encontrar aqui.