Appels et retours (API REST)

Dernière mise à jour : 31 mars 2025

Appels


Pour accéder aux points de terminaison de l'API, des appels HTTP doivent être envoyés à l'URL suivante.

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

Pour les appels de points de terminaison privés, les en-têtes HTTP suivants doivent être fournis : apiKey et
authent. L'inclusion du nonce dans la requête est facultative.

Exemple

Ce qui suit montre un exemple d'inclusion d'en-têtes HTTP en Java. Pour des exemples complets
et fonctionnels dans différents langages de programmation, consultez la section Implémentations d'exemples. 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); où apiKey et authent sont déterminés comme décrit précédemment.


Les appels de points de terminaison qui ne modifient pas l'état du serveur doivent être soumis avec requestType
= GET et avec postData soumis dans l'URL. Les appels de points de terminaison qui modifient l'état du serveur doivent être soumis avec requestType = POST et avec postData soumis dans l'URL. La section 4 détaille pour chaque point de terminaison le requestType à utiliser.

Retours


Les retours de l'API sont au format JSON. Si l'appel a réussi, le retour inclut les informations demandées
ou un retour d'information sur l'action demandée. Voir la section Erreur ! Référence source introuvable. pour une description des retours pour chaque point de terminaison.

Si un appel a réussi, la clé result dans la structure racine aura la valeur success.

Pour les appels de points de terminaison privés, les en-têtes HTTP suivants doivent être fournis : apiKey et
authent.

Exemple

Ce qui suit montre le retour d'un appel réussi du point de terminaison 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"
}
}


Notez que si un appel revient avec result égal à success, cela signifie simplement que la requête a été reçue et évaluée avec succès. Cela ne signifie pas nécessairement que l'opération souhaitée a été effectuée. Les détails sur le statut de l'opération sont renvoyés dans une clé status, le cas échéant.

Exemple

Ce qui suit montre le retour d'un appel réussi du point de terminaison sendorder où l'opération souhaitée n'a pas été effectuée. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Besoin d’aide supplémentaire ?