Chamadas e Retornos (API REST)

Última atualização: 31/03/2025

Chamadas


Para aceder aos pontos de extremidade da API, as chamadas HTTP precisam de ser enviadas para o seguinte URL.

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

Para chamadas de pontos de extremidade privados, os seguintes cabeçalhos HTTP devem ser fornecidos: apiKey e
authent. Incluir o nonce no pedido é opcional.

Exemplo

O seguinte mostra um exemplo para a inclusão de cabeçalhos HTTP em Java. Para exemplos completos
de trabalho em diferentes linguagens de programação, consulte a Secçã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.


As chamadas de pontos de extremidade que não alteram o estado do servidor devem ser submetidas com requestType
= GET e com postData a ser submetido no URL. As chamadas de pontos de extremidade que alteram o estado do servidor devem ser submetidas com requestType = POST e com postData a ser submetido no URL. A Secção 4 detalha para cada ponto de extremidade qual requestType deve ser usado.

Retornos


Os retornos da API estão em formato JSON. Se a chamada foi bem-sucedida, o retorno inclui as informações
solicitadas ou feedback sobre a ação solicitada. Consulte a Secção Erro! Fonte de referência não encontrada. para uma descrição dos retornos para cada ponto de extremidade.

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

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

Exemplo

O seguinte mostra o retorno de uma chamada bem-sucedida do ponto de extremidade 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"
}
}


Note que se uma chamada retornar com resultado igual a success, isso significa apenas que o pedido foi
recebido e avaliado com sucesso. Não significa necessariamente que a operação desejada tenha sido realizada. Detalhes sobre o estado da operação são retornados numa chave de estado, 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?