Tutoriel de l'API Kraken Futures

Comprendre Kraken Futures et l'écosystème de l'API

L' API Kraken Futures est un outil puissant conçu pour les commerçants et les développeurs à la recherche d'un accès automatisé au marché des dérivés de Kraken. Contrairement au trading spot, les contrats à terme permettent aux utilisateurs de spéculer sur les mouvements de prix des crypto-monnaies à l'aide de l'effet de levier. L' API Kraken Futures fournit des points de terminaison pour passer des commandes, récupérer les données du marché, gérer les postes et surveiller le statut de compte par programme. Cette API fonctionne sur les protocoles HTTPS et WebSocket, permettant à la fois les demandes basées sur REST et le streaming en temps réel des données.

Pour interagir avec l'API, vous devez d'abord comprendre ses deux environnements principaux: l'environnement de production sur futures.kraken.com et l'environnement de test de bac à sable sur demo-futures.kraken.com . Le bac à sable permet aux développeurs de tester des stratégies sans risquer de fonds réels. Tous les points de terminaison nécessitent une authentification à l'aide d'une clé API et d'un secret , qui sont générés via le tableau de bord de votre compte Kraken Futures.

Chaque demande aux points de terminaison privés doit inclure trois en-têtes:

• Apikey : Votre clé API publique
• Authentification : une signature HMAC SHA256 générée à partir de votre clé secrète
• NONCE : un nombre ou un horodatage unique et incréments

Ces mesures de sécurité garantissent que seuls les utilisateurs autorisés peuvent effectuer des actions telles que passer des commandes ou retirer des fonds.

Configuration de vos informations d'identification API Kraken Futures

Avant de passer des appels API, vous devez générer des informations d'identification valides dans votre compte Kraken Futures. Accédez à la section de gestion de l'API dans votre tableau de bord Kraken Futures. Assurez-vous que vous êtes connecté à l'environnement correct - en direct ou en démo - basé sur vos besoins de développement.

• Cliquez sur «Générer une nouvelle clé»
• Attribuez un nom descriptif à votre clé API pour une identification plus facile
• Sélectionnez les autorisations appropriées: placement des commandes , équilibre de lecture et positions
• Activer la liste blanche IP si nécessaire pour une sécurité supplémentaire
• Confirmer le processus de génération

Une fois terminé, vous recevrez deux composants critiques: la clé API (une longue chaîne alphanumérique) et le secret privé . Les stocker en toute sécurité. Le secret ne sera plus affiché après la fermeture de la boîte de dialogue. La perdre signifie que vous devrez révoquer et régénérer la clé.

À des fins de test, utilisez l'environnement de bac à sable pour éviter les métiers involontaires sur les marchés en direct. Lorsque vous basculez entre les environnements, mettez à jour votre URL de base en conséquence:

• Sandbox: https://demo-futures.kraken.com
• Live: https://futures.kraken.com

Mécanisme d'authentification pour les critères de terminaison privés

L'accès aux points de terminaison privés comme /orders , /positions , ou /account nécessite une authentification appropriée. Le cœur de ce processus réside dans la génération d'une signature HMAC-SHA256 valide. Cette signature est dérivée de votre secret privé et comprend le chemin de la demande, le nonce et le corps (le cas échéant).

Voici comment construire l'étape par étape de l'en-tête d'authentification:

• COMPATENER L'HOINSAGE UNIX actuel (en tant que nonce), le chemin de demande (par exemple, /api/v3/leads/status ) et le corps de demande (si post / put) dans une seule chaîne
• Utilisez votre secret privé pour calculer le hachage HMAC-SHA256 de cette chaîne concaténée
• Encoder le hachage résultant au format Base64
• Incluez cette valeur codée dans l'en-tête Authentification

Exemple de Python:

 import hmac import hashlib import time nonce = str (int (time.time () * 1000)) path = '/ api / v3 / ordres' body = '{' orderType ':' lmt ',' symbole ':' pi_xbtusd ',' côté ':' buy ',' size ': 1000,' limitprice ': 30000}'


message = nonce + chemin + corps signature = hmac.new (


b'your_private_secret_here', msg=message.encode(), digestmod=hashlib.sha256
 ).digérer()
 
auth_header = base64.b64encode (signature) .decode ()

Cette signature, ainsi que l' APIKey et Nonce , doivent être incluses dans chaque demande privée.

Passant un ordre à terme via l'API

Une fois authentifié, vous pouvez commencer à interagir avec les points de terminaison commerciaux. Pour passer une nouvelle commande, envoyez une demande de poste à /api/v3/sendorder . La charge utile doit inclure des paramètres essentiels tels que le symbole, le côté, la taille et le type de commande.

Champs requis dans le corps JSON:

• OrderType : peut être lmt (limite), mkt (marché) ou post (limite post-seulement)
• Symbole : par exemple, pi_xbtusd pour le contrat perpétuel Bitcoin / USD
• côté : buy ou sell
• Taille : nombre de contrats (minimum 1 pour la plupart des paires)
• LimitPrice : requis pour les ordres de limite

Exemple de demande à l'aide de Curl:

 curl -X POST https://futures.kraken.com/api/v3/sendorder \ -H 'APIKey: your_api_key_here' \ -H 'Nonce: 1234567890' \ -H 'Authentification: generated_signature_here' \ -d '{'orderType':'lmt','symbol':'pi_xbtusd','side':'buy','size':100,'limitPrice':35000}'

Après la soumission, l'API renvoie une réponse contenant l' orderId , le statut et d'autres métadonnées. Vous pouvez utiliser cet ID pour annuler ou interroger la commande plus tard.

Récupération des données du marché et des informations de compte

Les points de terminaison publics ne nécessitent pas d'authentification et sont idéaux pour récupérer les conditions du marché en temps réel. Les points de terminaison utiles incluent:

• GET /api/v3/tickers : Renvoie les derniers prix, les taux de financement et l'intérêt ouvert pour tous les symboles
• GET /api/v3/orderbook?symbol=pi_xbtusd : récupère le carnet de commandes de niveau 2
• GET /api/v3/history?symbol=pi_xbtusd&lastTime=...

Pour les données spécifiques au compte, utilisez des points de terminaison privés:

• GET /api/v3/accounts : affiche les soldes de marge, les capitaux propres et le PNL dans tous les livres
• GET /api/v3/positions : répertorie toutes les positions actives avec le prix d'entrée, la taille et les niveaux de liquidation
• GET /api/v3/orders : récupère les ordres ouverts; Ajouter ?order_status=closed pour voir ceux remplis / annulés

Toutes les réponses sont au format JSON, ce qui les rend faciles à analyser en code. Les intervalles de sondage devraient respecter les limites de taux - généralement 10 demandes par seconde pour les critères d'évaluation publiques et 5 pour les privés.

Gestion des erreurs et des appels d'API de débogage

Même avec une syntaxe correcte, les demandes d'API peuvent échouer en raison de paramètres non valides, de marges insuffisantes ou de problèmes de connectivité. Les codes d'état HTTP courants comprennent:

• 400 Mauvaise demande : JSON malformé ou manquants champs obligatoires
• 401 non autorisé : clé API non valide ou vérification de signature échouée
• 403 Interdit : IP pas les autorisations de liste blanche ou insuffisantes
• 429 trop de demandes : limite de taux dépassée

Les réponses d'erreur contiennent un code et un message error . Par exemple, 'error': 'Invalid signature' indique un décalage dans le calcul HMAC. Vérifiez la logique de concaténation et les étapes de codage.

Activer la journalisation des demandes et des réponses brutes pendant le développement. Des outils comme Postman ou Curl avec Flag -v aident à inspecter les en-têtes et les charges utiles. Valider les horodatages - ils doivent être dans une petite fenêtre (généralement ± 60 secondes) du temps du serveur de Kraken, récupérable via GET /api/v3/time .

Questions fréquemment posées

Comment trouver le bon symbole pour un contrat à terme? Les symboles suivent une convention de dénomination spécifique. Les perpétuaux commencent par pi_ , suivis de la base et de la monnaie de devis (par exemple, pi_ethusd ). Les futurs trimestriels utilisent le préfixe f_ et incluent la date d'expiration (par exemple, f_xbtusd_240628 ). Vérifiez /api/v3/instruments pour une liste complète.

Puis-je utiliser la même clé API pour le trading Spot et Futures? Non. Kraken Spot and Futures Plateforme fonctionne sur des systèmes séparés. Vous devez générer des touches API distinctes à partir du tableau de bord Kraken Futures , pas de l'interface principale Kraken.com.

Quelle est la taille minimale de la commande sur Kraken Futures? La plupart des contrats perpétuels ont une taille de commande minimale de 1 contrat. Un contrat équivaut généralement à 1 $ de l'actif sous-jacent. Pour pi_xbtusd , 1 contrat = 1 $ pour Bitcoin. Vérifiez toujours via /api/v3/instruments .

La prise en charge de WebSocket est-elle disponible pour Kraken Futures? Oui. Connectez-vous à wss://futures.kraken.com/ws/v1 pour les mises à jour en direct sur les livres de commande, les métiers et vos événements de commande privés. L'authentification implique l'envoi d'un token obtenu à partir du point de terminaison /api/v3/auth/token .