Chamadas e Retornos (API REST)

Última atualização: 7 de outubro de 2026

Chamadas


Para acessar os endpoints da API, é necessário enviar chamadas HTTP para a 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 exemplo a seguir demonstra a inclusão de cabeçalhos HTTP em Java. Para exemplos completos em diferentes linguagens de programação, consulte a Seção Implementações de Exemplo. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
exemplos 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 enviado na URL. Chamadas de endpoints que alteram o estado do servidor devem ser enviadas com requestType = POST e com postData 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 for bem-sucedida, o retorno inclui as informações solicitadas
ou o feedback sobre a ação solicitada. Consulte a Seção Erro! Fonte de referência não encontrada. para uma descrição dos retornos de cada endpoint.

Se uma chamada for bem-sucedida, a chave result 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 exemplo a seguir mostra o retorno de uma chamada bem-sucedida ao 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. Isso não significa necessariamente que a operação desejada foi executada. Detalhes sobre o status da operação são retornados em uma chave status, quando aplicável.

Exemplo

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