Chamadas e Retornos (API REST)

Última atualização: 31 de mar. de 2025

Chamadas


Para acessar os endpoints da API, as chamadas HTTP precisam ser enviadas para o seguinte URL.

https://futures.kraken.com/derivatives/api/v3

Para chamadas de endpoints privados, os seguintes cabeçalhos HTTP devem ser fornecidos: apiKey e
authent. A inclusão do nonce na solicitação é opcional.

Exemplo

O seguinte mostra um exemplo para a inclusão de cabeçalhos HTTP em Java. Para exemplos completos
e funcionais em diferentes linguagens de programação, consulte a Seção Implementações de Exemplo. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
URL obj = new URL(url);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
...
con.setRequestProperty("APIKey", apiKey);
con.setRequestProperty("Authent", authent); onde apiKey e authent são determinados conforme descrito anteriormente.


Chamadas de endpoints que não alteram o estado do servidor devem ser enviadas com requestType
= GET e com postData sendo enviado na URL. Chamadas de endpoints que alteram o estado do servidor devem ser enviadas com requestType = POST e com postData sendo enviado na URL. A Seção 4 detalha para cada endpoint qual requestType deve ser usado.

Retornos


Os retornos da API estão no formato JSON. Se a chamada foi bem-sucedida, o retorno inclui as informações solicitadas
ou feedback sobre a ação solicitada. Consulte a Seção Error! Reference source not found. para uma descrição dos retornos para cada endpoint.

Se uma chamada foi bem-sucedida, a chave de resultado na estrutura raiz terá o valor success.

Para chamadas de endpoints privados, os seguintes cabeçalhos HTTP devem ser fornecidos: apiKey e
authent.

Exemplo

O seguinte mostra o retorno de uma chamada bem-sucedida do endpoint sendorder.
{
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"placed",
"order_id":"c18f0c17-9971-40e6-8e5b10df05d422f0"
}
}


Observe que se uma chamada retornar com result igual a success, isso significa apenas que a solicitação foi
recebida e avaliada com sucesso. Não significa necessariamente que a operação desejada foi realizada. Detalhes sobre o status da operação são retornados em uma chave de status, quando aplicável.

Exemplo

O seguinte mostra o retorno de uma chamada bem-sucedida do endpoint sendorder onde a operação desejada não foi realizada. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Precisa de mais ajuda?