Comment puis-je obtenir des données de contrat historiques de l'API Kraken?

Répondez les données OHLC historiques Kraken Futures via `Futures-api.kraken.com / API / HISTORY / CANDLES` Utilisation de Symbol, Interval et Unix Timesstamps; Authentifiez avec la clé API et la signature HMAC-SHA256 si le taux est limité.

Aug 08, 2025 at 02:49 pm

Comprendre l'API Kraken et les données de contrat historiques

L' API Kraken est une interface puissante qui permet aux développeurs et aux commerçants d'interagir avec les services d'échange de crypto-monnaie de Kraken par programme. Lorsque vous faites référence aux données historiques des contrats , il est important de clarifier que Kraken prend principalement en charge les contrats de trading et à terme via sa plate-forme Kraken Futures (anciennement connue sous le nom de dérivés de Cryptowatch). L'API standard de Kraken REST (api.kraken.com) ne fournit pas de données historiques pour les contrats à terme ou les contrats perpétuels. Au lieu de cela, les données historiques des contrats sont accessibles via l' API Kraken Futures , hébergée sur Futures-api.kraken.com.

Pour récupérer les données historiques, vous devez identifier le point de terminaison correct en fonction du type de contrat et du délai nécessaire. L'API Kraken Futures propose des points de terminaison tels que /api/history/candles pour récupérer des données OHLC (ouvertes, élevées, faibles, clôturées) pour des contrats à terme spécifiques. Chaque point final nécessite des paramètres comme le symbole , l'intervalle et de / jusqu'à / jusqu'à des horodatages pour définir la plage de données.

Configuration des informations d'accès à l'accès à l'API

Avant de faire des demandes, vous devez configurer un accès authentifié à l'API Kraken Futures. Cela implique de créer une clé API et un secret:

• Connectez-vous à votre compte Kraken et accédez à la section de financement .
• Sélectionnez API et choisissez Kraken Futures .
• Cliquez sur Créer la touche API .
• Attribuer des autorisations - L'accès à la lecture d'insurateurs est activé pour les données du marché.
• Générez la clé et stockez en toute sécurité la clé API et la clé secrète .

Ces informations d'identification sont nécessaires pour signer des demandes en utilisant HMAC-SHA256. Contrairement au trading spot, Kraken Futures utilise un mécanisme d'authentification distinct. Chaque demande doit inclure des en-têtes tels APIKey et Authent , où Authent est la signature calculée en fonction de la méthode de la demande, du chemin, du corps et de l'horodatage.

Construire la demande d'API pour les données historiques

Pour récupérer les données de contrat historiques, utilisez le point de terminaison de l'histoire des bougies :

 GET https://futures-api.kraken.com/api/history/candles

Les paramètres de requête requis comprennent:

• Symbole : Le symbole du contrat, tel que PI_XBTUSD pour le contrat inverse perpétuel Bitcoin.
• Intervalle : L'intervalle de chandelier. Les valeurs valides comprennent 1m , 5m , 15m , 1h , 4h , 1d .
• De : heure de début dans l'horodatage Unix (secondes).
• Jusqu'à : heure de fin dans l'horodatage UNIX (secondes).

Par exemple, aller chercher des bougies d'une heure pour le contrat perpétuel Bitcoin du 1er janvier 2024 au 2 janvier 2024:

 https://futures-api.kraken.com/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600

Cette demande ne nécessite pas d'authentification si seules les données du marché public sont accessibles. Cependant, si le taux est limité, envisagez d'utiliser des demandes authentifiées.

Gestion de l'authentification pour les demandes limitées à taux

Si vous dépassez la limite de demande non authentifiée, passez aux demandes signées. Le processus implique:

• Création d'une charge utile de demande avec la méthode, le chemin, le corps et l'horodatage ISO 8601.
• Concaténer l'horodatage, la méthode, le chemin et le corps (s'ils sont présents) dans une chaîne de signature.
• Utiliser HMAC-SHA256 avec votre clé secrète pour générer une signature.
• Y compris la signature dans l'en-tête Authent et votre clé dans APIKey .

Exemples d'étapes de Python:

• Définir la méthode de la demande: GET
• Définissez le chemin: /api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• Générer l'horodatage ISO: 2024-01-01T00:00:00Z
• Construisez le message de signature: 2024-01-01T00:00:00ZGET/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• Calculez HMAC-SHA256 du message en utilisant votre clé secrète
• Encoder le résultat dans la base64
• Définir les en-têtes:
  • APIKey: YOUR_PUBLIC_KEY
  • Authent: BASE64_SIGNATURE
  • Nonce: 2024-01-01T00:00:00Z

Envoyez la demande à l'aide d'une bibliothèque comme requests .

Traitement et stockage des données de réponse

L'API renvoie une réponse JSON contenant un tableau d'objets de bougie. Chaque bougie comprend:

• Timestamp : Unix Time of the Candle Start.
• Ouvert : prix d'ouverture.
• Haut : prix le plus élevé.
• Bas : prix le plus bas.
• CLOSE : Prix de clôture.
• Volume : volume échangé.

Exemple de réponse:

 {
 'result': 'success',
 'candles': [ { 'timestamp': 1704067200, 'open': '42000.00', 'high': '42500.00', 'low': '41800.00', 'close': '42300.00', 'volume': '120.5' }

]]
}

Analyser le JSON et extraire le réseau candles . Vous pouvez stocker ces données dans CSV, une base de données ou une dataframe pour l'analyse. Assurez-vous que les horodatages sont convertis en heure locale ou en UTC au besoin. Gérer la pagination si la plage de temps est grande - Kraken peut limiter les résultats par demande, nécessitant plusieurs appels avec des valeurs from et until les valeurs.

Erreurs communes et dépannage

• Symbole non valide : Vérifiez le symbole du contrat. Utilisez GET /api/instruments pour répertorier tous les contrats disponibles.
• Limitation des taux : les demandes non authentifiées sont limitées. Utilisez l'authentification ou ajoutez des retards entre les appels.
• Format d'horodatage non valide : assurez-vous que les horodatages Unix sont en secondes, pas des millisecondes.
• Déliachance de signature : Vérifiez que la chaîne de signature comprend le chemin exact et les paramètres de requête, et que la clé secrète est correcte.
• Réponse vide : confirmez que la plage de temps comprend des périodes de trading actif.

Utilisez des outils comme Postman ou Python Scripts pour tester les demandes de manière progressive. Activer la journalisation pour capturer les en-têtes de demande et les réponses pour le débogage.

Questions fréquemment posées

Comment trouver le bon symbole pour un contrat à terme Kraken?

Utilisez le point de terminaison des instruments : GET https://futures-api.kraken.com/api/instruments . Cela renvoie tous les contrats actifs avec leurs symboles, tels que PI_XBTUSD pour Bitcoin perpétuels ou FI_ETHUSD pour les futures éther.

Puis-je récupérer des données historiques au niveau des tiques au lieu des bougies?

L'API Kraken Futures ne fournit pas de données au niveau des tiques via des points de terminaison publics. Le point de terminaison /api/history/candles prend en charge uniquement les données OHLC agrégées à des intervalles spécifiés. Pour les données granulaires, envisagez des flux WebSocket ou des fournisseurs de données tiers.

Y a-t-il une limite à la quantité de données historiques que je peux récupérer en même temps?

Oui, l'API peut limiter le nombre de bougies retournées par demande. Si votre plage de temps est grande, divisez-la en intervalles plus petits - comme un jour à la fois et faites plusieurs demandes. Vérifiez la réponse pour l'exhaustivité et ajustez les paramètres from et until les paramètres en conséquence.

Dois-je être un utilisateur Kraken vérifié pour accéder aux données des contrats historiques?

Pour les demandes de données publiques non authentifiées, l'accès au compte de base suffit. Cependant, pour augmenter les limites de taux et garantir un accès stable, un compte vérifié avec des informations d'identification de l'API est recommandé. Les autorisations de trading complètes ne sont pas requises pour la récupération des données.