Comment fonctionne l'API Kraken pour le trading de contrats?

Comprendre l'API Kraken pour le trading contractuel

L' API Kraken fournit une interface robuste pour interagir avec les produits financiers de Kraken, y compris les contrats à terme et les contrats perpétuels . Alors que Kraken est traditionnellement connu pour ses services de trading au comptant, son expansion en dérivés par Kraken Futures - alimentée par la technologie des installations cryptographiques - permet aux utilisateurs de négocier des contrats à terme perpétuels sur diverses crypto-monnaies. L'API permet aux commerçants d'automatiser les stratégies, de gérer les positions et de récupérer les données du marché en temps réel. L'accès au trading de contrats via l'API nécessite une authentification à l'aide de clés d'API , qui sont générées dans les paramètres du compte Kraken. Ces clés accordent l'autorisation d'effectuer des actions telles que la mise en place de commandes, la vérification des soldes et la récupération des informations de position.

Pour commencer à utiliser l'API Kraken pour le trading de contrats, vous devez d'abord naviguer vers le portail Kraken Futures (Futures.kraken.com), où vous pouvez générer une clé API dédiée. Contrairement au trading spot, l'accès à l'API à terme est géré séparément. Une fois la clé créée, elle doit être utilisée avec l'URL de base Futures.kraken.com au lieu du point de terminaison de l'API SPOT standard. L'API prend en charge les protocoles REST et WebSocket , permettant à la fois les demandes synchrones et le streaming en temps réel des données de marché.

Authentification et configuration de la clé API

Avant de passer des appels API, vous devez configurer une authentification appropriée. Cela implique de générer une clé API et un secret à travers le tableau de bord Kraken Futures.

• Connectez-vous à votre compte Kraken Futures
• Accédez à Paramètres> API
• Cliquez sur «Créer une clé API»
• Attribuer des autorisations: assurer la «commande» et les requêtes »et les droits de« retrait » sont activés si nécessaire
• Enregistrez la clé de l'API et le secret privé en toute sécurité

L'authentification pour l'API Kraken Futures utilise des signatures HMAC-SHA256 . Chaque demande doit inclure les en-têtes suivants:

• Apikey : Votre clé publique générée
• Authentification : la signature HMAC générée à partir des données de demande
• Type de contenu : Application / JSON

La signature est calculée à l'aide du secret privé, du chemin de demande, nonce (un nombre strictement croissant) et du corps de demande. Les bibliothèques de Python, Node.js et d'autres langues peuvent automatiser ce processus. Par exemple, dans Python, vous pouvez utiliser la bibliothèque requests avec hmac et hashlib pour signer les demandes correctement.

Récupération des informations sur le marché et les contrats

Pour échanger efficacement les contrats, vous devez d'abord comprendre les instruments disponibles. L'API Kraken Futures fournit des points de terminaison pour répertorier tous les contrats négociables.

• Envoyez une demande GET à https://futures.kraken.com/derivatives/api/v3/instruments
• La réponse comprend le symbole, les exigences de marge, les taux de financement et l'effet de levier maximal
• Chaque symbole de contrat suit une convention de dénomination telle que PI_XBTUSD (perpétuel inverse Bitcoin / USD) ou PF_SOLUSD (Futures perpétuelles Solana / USD)

Vous pouvez également récupérer les données du livre de commandes en temps réel en utilisant le point de terminaison:

• https://futures.kraken.com/derivatives/api/v3/tickers Cela renvoie la dernière offre, demandez, dernier prix négocié et intérêt ouvert pour chaque contrat. Pour plus d'informations sur le marché, utilisez le point de terminaison du manuel de commandes avec un symbole spécifié pour récupérer la profondeur complète de Bid / Ask.

Placer et gérer les ordres contractuels

Une fois que vous avez identifié une opportunité de trading, vous pouvez passer des commandes en utilisant le point de terminaison SendOrd . Cela nécessite une demande de poste à:

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

Les paramètres requis incluent:

• OrderType : comme LMT (limite), MKT (Market) ou Post (post-uniquement)
• Symbole : l'identifiant du contrat (par exemple, pi_ethusd )
• côté : acheter ou vendre
• Taille : le nombre de contrats
• LimitPrice : requis pour les ordres de limite

Par exemple, pour passer une commande d'achat de limite pour 100 contrats de pi_xbtusd à 43 000 $:

 { 'orderType': 'lmt', 'symbol': 'PI_XBTUSD', 'side': 'buy', 'size': 100, 'limitPrice': 43000 }

Après la soumission, l'API renvoie un ID de commande , que vous pouvez utiliser pour surveiller l'exécution. Pour vérifier les commandes actives, utilisez le point de terminaison OpenOrders . Pour annuler une commande, envoyez une demande d' annulation avec l'ID de commande.

Surveillance des positions et des données de compte

Le suivi de position en temps réel est essentiel pour la gestion des risques. Le point de terminaison des positions renvoie toutes les positions à terme ouverts:

• https://futures.kraken.com/derivatives/api/v3/positions La réponse comprend le prix d'entrée, le prix de marque actuel, le PNL (profit et perte) et le prix de liquidation .

Les données au niveau du compte, telles que la marge disponible, le solde de garantie et les paramètres de levier , peuvent être récupérées via le point de terminaison des comptes . Cela permet de vous assurer de rester dans des seuils de marge sûrs. Vous pouvez également ajuster l'effet de levier pour des contrats spécifiques à l'aide du point de terminaison de SetleEvery , spécifiant le symbole et la valeur de levier souhaitée (par exemple, 5x, 10x).

Utilisation de WebSocket pour des mises à jour en temps réel

Pour le trading à haute fréquence ou la surveillance en temps réel, l' API Websocket Kraken Futures est plus efficace que d'interroger les points de terminaison de repos. Connectez-vous à:

• wss: //futures.kraken.com/ws/v1

Après avoir connecté, abonnez-vous à des canaux tels que:

• Ticker : mises à jour de prix en temps réel
• Livre : Modifications de commandes changements
• Exécutions : votre métier remplit
• Positions : mises à jour de vos positions ouvertes

Chaque abonnement nécessite une charge utile JSON. Par exemple, pour vous abonner au ticker PI_XBTUSD:

 { 'event': 'subscribe', 'feed': 'ticker', 'product_ids': ['PI_XBTUSD'] }

Les messages sont poussés en temps réel, réduisant la latence. Les connexions WebSocket doivent être authentifiées si l'accès aux données privées. Cela implique l'envoi d'un message de connexion avec votre clé API, votre NONCE et votre jeton signé.

Questions fréquemment posées

L'API Kraken Spot est-elle compatible avec le trading à terme? Non. L'API Kraken Spot (api.kraken.com) ne prend pas en charge les contrats à terme. Vous devez utiliser les points de terminaison Futures.kraken.com avec une clé API générée séparément de la plate-forme Kraken Futures.

Quelle est la différence entre les contrats PI_XBTUSD et PF_EURUSD? PI_XBTUSD est un contrat perpétuel inverse libellé dans Bitcoin, ce qui signifie que PNL est réglé en BTC. PF_EURUSD est un contrat perpétuel à marge de fiat, où les garanties et la PNL sont en USD, fournissant une exposition à la valeur stable.

Puis-je utiliser la même clé API pour plusieurs stratégies? Oui, mais il est recommandé de créer des clés API distinctes pour différents robots ou stratégies. Cela améliore la sécurité et permet un contrôle de l'autorisation granulaire, tel que la restriction d'une clé à un accès en lecture seule.

À quelle fréquence le financement est-il payé sur les contrats perpétuels? Le financement est échangé toutes les 8 heures à 00:00 UTC, 08:00 UTC et 16h00 UTC. Le taux dépend de la prime entre le prix du contrat perpétuel et l'indice sous-jacent. Les positions longues paient des positions courtes si le taux est positif, et vice versa.