Comment utiliser l'API REST de Kraken?

L'API REST de Kraken vous permet d'automatiser le trading et de gérer votre compte; Il nécessite la configuration des clés d'API et l'authentification des demandes avec une signature.

Apr 24, 2025 at 04:56 am

L'utilisation de l'API REST de Kraken vous permet d'interagir par programme avec l'échange de crypto-monnaie Kraken, vous permettant d'automatiser le trading, de gérer votre compte et de récupérer les données du marché. Cet article vous guidera tout au long du processus de configuration et d'utilisation de l'API REST de Kraken, couvrant l'authentification, la création de demandes et la compréhension de la structure de l'API.

Comprendre l'API REST de Kraken

L'API REST de Kraken est un outil puissant conçu pour les développeurs qui ont besoin d'interagir avec l'échange par programme. L'API est divisée en deux catégories principales: les points de terminaison publics et privés . Les points de terminaison publics permettent d'accéder aux données du marché, telles que les informations de ticker, les livres de commandes et les métiers récents. Les critères de terminaison privés, en revanche, nécessitent une authentification et donnent accès aux données spécifiques à l'utilisateur, y compris les soldes de compte, la gestion des commandes et l'historique du commerce.

Configuration de vos touches API

Avant de pouvoir utiliser les points de terminaison privés, vous devez configurer vos clés API. Voici comment le faire:

• Connectez-vous à votre compte Kraken et accédez à la section Paramètres .
• Cliquez sur l'API pour accéder à la page de gestion de l'API.
• Cliquez sur Générer une nouvelle clé . Vous serez invité à saisir un nom pour votre clé et à sélectionner les autorisations que vous souhaitez accorder.
• Après avoir généré la clé, vous verrez une clé API et un secret d'API . Enregistrez-les en toute sécurité , car ils seront utilisés pour authentifier vos demandes d'API.

Authentification des demandes d'API

Pour authentifier vos demandes aux points de terminaison privés, vous devez inclure une signature dans votre demande. Voici comment créer la signature:

• Générez un nonce , qui est un numéro unique qui ne doit être utilisé qu'une seule fois. Vous pouvez utiliser l'horodatage actuel en millisecondes à cet effet.
• Créez le chemin API que vous demandez (par exemple, /0/private/Balance ).
• CONTRÔLER LE NONCE ET LES DONNÉES DE POST (le cas échéant) en une seule chaîne.
• Créez le message en concaténant le chemin API, l'API NONCE et la chaîne de données post-Data.
• Utilisez l'algorithme SHA-256 pour hacher le message.
• Utilisez l'algorithme HMAC-SHA512 avec votre secret API pour signer le hachage.
• Incluez la clé API, le nonce et la signature dans les en-têtes de demande.

Voici un exemple d'extrait de code Python pour illustrer le processus:

 import time
 import hashlib
 import hmac
 import requests api_key = 'your_api_key'
 api_secret = 'your_api_secret'.encode ()



def get_kraken_signature (urlPath, data, secret):


postdata = urllib.parse.urlencode(data) encoded = (str(data['nonce']) + postdata).encode() message = urlpath.encode() + hashlib.sha256(encoded).digest() signature = hmac.new(secret, message, hashlib.sha512) return signature.hexdigest()
 def kraken_request (uri_path, data, api_key, api_secret):
 
headers = {} headers['API-Key'] = api_key headers['API-Sign'] = get_kraken_signature(uri_path, data, api_secret) req = requests.post((api_url + uri_path), headers=headers, data=data) return req
 Exemple d'utilisation
 api_url = 'https://api.kraken.com'
 uri_path = '/ 0 / private / bilan'
 data = {'nonce': str (int (1000 * time.time ()))}
 resp = kraken_request (uri_path, data, api_key, api_secret)

Faire des demandes d'API

Une fois que vous avez configuré vos clés API et comprendre comment authentifier vos demandes, vous pouvez commencer à passer des appels API. Voici quelques exemples de demandes communes:

• Exemple de point de terminaison public: Récupération des informations des ticles

  • URL: https://api.kraken.com/0/public/Ticker?pair=XBTUSD
  • Cette demande renverra les informations actuelles de ticker pour la paire Bitcoin à USD.

• Exemple de point final privé: Solde de compte chèque

  • URL: https://api.kraken.com/0/private/Balance
  • Vous devez inclure les en-têtes d'authentification comme décrit précédemment.

Gestion des réponses

L'API de Kraken retourne les réponses au format JSON. Voici comment gérer les réponses:

• Analyser la réponse JSON à l'aide d'un analyseur JSON dans votre langage de programmation de choix.
• Vérifiez le champ d'erreur dans la réponse. Si ce n'est pas nul, cela signifie qu'une erreur s'est produite et vous devez le gérer en conséquence.
• Extraire le champ de résultats pour accéder aux données renvoyées par l'API.

Voici un exemple de la façon de gérer une réponse dans Python:

 import json En supposant que «resp» est l'objet de réponse de la fonction kraken_request
 réponse_json = resp.json ()


Si 'Error' dans Response_JSON et Response_JSON ['ERROR']:


print('Error:', response_json['error'])
 autre:
 
print('Result:', response_json['result'])
 Limitation des taux et meilleures pratiques
 L'API de Kraken a des limites de taux pour prévenir les abus. Vous devez être conscient de ces limites et mettre en œuvre des mesures appropriées dans votre code :
 
Les points de terminaison publics ont une limite de 15 demandes par seconde.
 Les points de terminaison privés ont une limite de 1 demande par seconde pour les comptes non vérifiés et jusqu'à 20 demandes par seconde pour les comptes vérifiés.
 Voici quelques meilleures pratiques à suivre:
 
Implémentez la logique de réessayer avec le revers exponentiel pour gérer les erreurs de limitation de taux.
 Le cache a fréquemment accédé aux données pour réduire le nombre de demandes.
 Utilisez des demandes asynchrones pour améliorer l'efficacité de votre application.
 Dépannage des problèmes communs
 Lorsque vous utilisez l'API REST de Kraken, vous pouvez rencontrer plusieurs problèmes communs. Voici quelques conseils de dépannage:
 
Signature non valide : Vérifiez que votre nonce est unique et que vous signiez correctement vos demandes.
 Limite de taux dépassée : assurez-vous que vous respectez les limites de taux et que vous mettez en œuvre une logique de réessayer appropriée.
 Problèmes de clé de l'API : assurez-vous que votre clé API a les autorisations nécessaires et que vous utilisez la clé et le secret corrects.
 FAQ
 Q: Puis-je utiliser l'API REST de Kraken pour échanger simultanément plusieurs crypto-monnaies?
 
R: Oui, vous pouvez utiliser l'API REST de Kraken pour gérer et échanger plusieurs crypto-monnaies. Vous devrez effectuer des appels API séparés pour chaque paire de crypto-monnaie que vous souhaitez échanger, en vous assurant de respecter les limites de taux et de gérer efficacement vos demandes d'API.
 
Q: Comment puis-je assurer la sécurité de mes clés API lors de l'utilisation de l'API REST de Kraken?
 
R: Pour assurer la sécurité de vos clés API, stockez-les dans un environnement sécurisé, tels que des variables d'environnement ou un coffre-fort sécurisé. Ne codez jamais dur vos clés dans votre code source et limitez les autorisations de vos clés API au minimum requis pour votre application.
 
Q: Quelles sont les différences entre les paramètres publics et privés de Kraken?
 
R: Les points de terminaison publics donnent accès aux données du marché et ne nécessitent pas d'authentification. Ils incluent des informations telles que les données de billeur, les livres de commandes et les métiers récents. Les points de terminaison privés nécessitent une authentification et donner accès aux données spécifiques à l'utilisateur, telles que les soldes de compte, la gestion des commandes et l'historique des échanges.
 
Q: Comment puis-je gérer les erreurs et les exceptions lors de l'utilisation de l'API REST de Kraken?
 
R: Pour gérer les erreurs et les exceptions, vous devez toujours vérifier le champ «Erreur» dans la réponse de l'API. Implémentez la logique de gestion des erreurs pour gérer différents types d'erreurs, telles que la limite de taux dépassée, la signature non valide ou les erreurs de serveur. Utilisez des blocs de capture d'essai dans votre code pour gérer gracieusement les exceptions et implémentez la logique de réessayer le cas échéant.