Comment utiliser l'API Kraken Futures avec Python ? (Guide du développeur)

Configuration des informations d'authentification

1. Connectez-vous à votre compte Kraken et accédez à la section Paramètres sous API.

2. Générez une nouvelle paire de clés API spécifiquement pour le trading de contrats à terme, en vous assurant que l'autorisation « Futures » est activée.

3. Stockez la clé API et la clé privée en toute sécurité : ne les codez jamais en dur dans les fichiers sources et ne les confiez jamais au contrôle de version.

4. Utilisez des variables d'environnement telles que KRAKEN_FUTURES_API_KEY et KRAKEN_FUTURES_PRIVATE_KEY pour injecter des informations d'identification au moment de l'exécution.

5. Validez les clés en effectuant une demande authentifiée minimale, telle que la récupération des soldes des comptes via le point de terminaison GET /api/v3/accounts .

Installation et configuration des bibliothèques requises

1. Installez le SDK Python officiel Kraken Futures à l'aide de pip : pip install kraken-futures-api .

2. Vous pouvez également utiliser les requêtes directement si un contrôle précis des en-têtes et de la logique de signature est nécessaire.

3. Importez les modules nécessaires : KrakenFuturesAPI , json et base64 pour la génération manuelle de signatures.

4. Initialisez le client avec vos informations d'identification : client = KrakenFuturesAPI(key=key, secret=secret) .

5. Confirmez la connectivité en appelant client.get_server_time() et en vérifiant que la réponse contient un horodatage Unix valide.

Passer et gérer les commandes à terme

1. Construisez une charge utile d'ordre spécifiant le symbole (par exemple, PI_XBTUSD ), le côté ( acheter ou vendre ), la taille et le type d'ordre ( limite , marché , stop ).

2. Soumettez la commande en utilisant client.send_order(...) , qui renvoie une réponse structurée contenant order_id , status et fill_size .

3. Annulez une commande active avec client.cancel_order(order_id) et validez le statut d'annulation dans le JSON renvoyé.

4. Récupérez les commandes ouvertes à l'aide de client.get_open_orders() , en filtrant par symbole ou ID de commande si nécessaire.

5. Surveillez les remplissages en temps réel en interrogeant client.get_fills() ou en intégrant le flux WebSocket de Kraken pour les événements d'exécution.

Gestion des données de marge et de position

1. Récupérez les exigences de marge actuelles par contrat avec client.get_margin_requirements(symbol='PI_XBTUSD') .

2. Recherchez les positions ouvertes via client.get_open_positions() , en inspectant des champs tels que size , mark_price et unrealized_pnl .

3. Ajustez l'effet de levier pour une position à l'aide de client.set_leverage(symbol='PI_XBTUSD', lever=5) , sous réserve des règles de marge échelonnées de Kraken.

4. Clôturez explicitement une position en soumettant un ordre de marché opposé correspondant à la taille actuelle, ou utilisez client.close_position(symbol='PI_XBTUSD') .

5. Analysez les indicateurs de risque de liquidation de client.get_account_summary() , en particulier margin_level et available_margin .

Foire aux questions

Q : Puis-je utiliser la même clé API pour les points de terminaison Spot et Futures ? R : Non. Kraken nécessite des clés API distinctes pour les services Spot et Futures. Les clés générées dans les paramètres de l'API Spot ne disposent pas des autorisations Futures et renverront HTTP 403 sur les points de terminaison Futures.

Q : Que se passe-t-il si la signature de ma commande expire ? R : Kraken impose une fenêtre de validité de 60 secondes pour les demandes signées. Si l'horodatage dans l'en-tête Kraken-Api-Key diffère de l'heure du serveur de plus de 60 secondes, la demande échoue avec le code d'erreur EAPI:Invalid nonce .

Q : Comment puis-je interpréter le champ de statut dans les réponses à la commande ? R : Les valeurs valides incluent accepté , déclenché , annulé , rempli et expiré . Chacun reflète une étape distincte du cycle de vie régie par les conditions de prix et le traitement du système.

Q : Y a-t-il une limitation de débit sur l'API Futures ? R : Oui. Kraken applique des limites de débit dynamiques en fonction du niveau de compte et de la catégorie du point de terminaison. Le dépassement des limites renvoie HTTP 429 et inclut un en-tête Retry-After indiquant la durée du délai en secondes.