Comment utiliser l'API Kucoin?

Comprendre la structure de l'API Kucoin

1. L'API Kucoin est une interface RESTful qui permet aux développeurs d'interagir avec l'échange par programme. Il prend en charge les fonctionnalités telles que la récupération des données du marché, la mise en place des métiers, la gestion des commandes et l'accès aux informations de compte. Chaque point final suit un format URL standardisé, commençant généralement par https://api.kucoin.com .

2. L'authentification est requise pour les critères de terminaison privés et est réalisée en utilisant une combinaison de clé API, de clé secrète et de phrase secrète. Ces informations d'identification sont générées dans le compte d'utilisateur de Kucoin dans la section API Management. Le processus d'authentification consiste à créer une signature à l'aide du cryptage HMAC-SHA256 basé sur les paramètres de demande et l'horodatage.

3. Les points de terminaison publics, tels que ceux des données de ticker ou des instantanés de carnet de commandes, ne nécessitent pas d'authentification. Ceux-ci sont accessibles directement via des demandes de GET HTTP. Les développeurs doivent adhérer aux limites de taux pour éviter d'être temporairement bloquées. Kucoin applique des politiques de limitation des taux stricts, en particulier pour les demandes à haute fréquence.

4. Toutes les réponses sont retournées au format JSON, ce qui facilite l'analyse et l'intégration dans divers environnements de programmation. Les messages d'erreur suivent également une structure cohérente, y compris le code, le message et les détails supplémentaires le cas échéant. Une bonne gestion des erreurs est essentielle pour maintenir des performances d'application robustes.

5. Kucoin prend en charge les connexions WebSocket pour le streaming de données en temps réel. Cela comprend les mises à jour sur les livres de commandes, les exécutions commerciales et les changements d'équilibre. Les points de terminaison WebSocket nécessitent une connexion signée pour les données privées mais permettent des flux de marché public sans authentification.

Configuration des informations d'identification de l'API

1. Pour commencer à utiliser l'API Kucoin, les utilisateurs doivent se connecter à leur compte Kucoin et accéder à la section «gestion de l'API». Ici, ils peuvent créer une nouvelle clé API en spécifiant des autorisations telles que la lecture, le trading ou l'accès à retrait. Il est crucial d'attribuer uniquement les autorisations nécessaires pour minimiser les risques de sécurité.

2. Pendant le processus de création, les utilisateurs seront invités à définir une liste blanche IP. Cela améliore la sécurité en restreignant l'accès à l'API à des adresses IP spécifiques. Si aucune IP n'est spécifiée, la clé API peut être utilisée à partir de n'importe quel emplacement, ce qui augmente la vulnérabilité à une utilisation non autorisée.

3. Après avoir généré la clé API, la clé secrète et la phrase secrète, ces valeurs doivent être stockées en toute sécurité. La clé secrète et la phrase de passe ne sont indiquées qu'une seule fois pendant la création et ne peuvent pas être récupérées plus tard. Les perdre signifie que la clé doit être révoquée et régénérée.

4. Les développeurs doivent éviter les informations d'identification de codage rigide dans les fichiers source. Au lieu de cela, les variables d'environnement ou les fichiers de configuration sécurisés doivent être utilisés pour stocker des informations sensibles. Cette pratique réduit le risque d'exposition accidentelle, en particulier lors de l'utilisation de systèmes de contrôle de version.

5. Kucoin autorise plusieurs clés API par compte, permettant à différentes applications ou services de fonctionner indépendamment. Chaque clé peut avoir des autorisations distinctes et des restrictions IP, fournissant un contrôle granulaire sur l'accès et les fonctionnalités.

Exécuter les métiers et gérer les commandes

1. Passant une commande via l'API Kucoin implique l'envoi d'une demande de poste au point de terminaison / API / V1 / ORDERS. Les paramètres requis incluent le symbole (par exemple, BTC-USDT), le type de commande (limite ou le marché), le côté (acheter ou vendre) et la taille ou les fonds en fonction du type de commande.

2. Pour les ordres de limite, le paramètre de prix doit être inclus. Les commandes d'achat du marché nécessitent le montant de la monnaie de devis (par exemple, USDT), tandis que les commandes de vente du marché nécessitent le montant de la monnaie de base (par exemple, BTC). Une utilisation incorrecte des paramètres entraîne des erreurs de validation.

3. Une fois soumis, l'API renvoie un ID de commande, qui peut être utilisé pour suivre l'état du commerce. Les développeurs peuvent interroger les détails des commandes à l'aide du point de terminaison / API / V1 / ORDERS / {ORDERID} ou récupérer une liste de commandes actives via / API / V1 / ORDERS avec des filtres appropriés.

4. L'annulation d'une commande est effectuée via une demande de suppression au même point de terminaison, en spécifiant l'ID de commande. L'annulation par lots est également prise en charge pour plusieurs commandes sous le même symbole ou sur tous les symboles, selon le point de terminaison utilisé.

5. Les mises à jour des commandes en temps réel peuvent être surveillées à l'aide de WebSocket Feed / Market / Level2 , qui fournit des modifications incrémentielles du carnet de commandes. Cela permet des stratégies de trading à haute fréquence et réduit la latence par rapport aux points de terminaison de repos.

Questions fréquemment posées

Quelle est la limite de taux pour les demandes de l'API Kucoin? Les points de terminaison publics permettent jusqu'à 600 demandes par minute par IP, tandis que les points de terminaison privés sont limités à 600 demandes par minute par utilisateur. Dépasser ces limites entraîne une interdiction temporaire. Les développeurs doivent mettre en œuvre des mécanismes de limitation pour rester dans ces seuils.

Puis-je utiliser l'API Kucoin pour le trading des marges? Oui, Kucoin fournit des points de terminaison API pour le trading de marge sous le chemin / API / V1 / MARGIN / ORDERS. Les utilisateurs doivent activer le trading sur la marge sur leur compte et s'assurer que leur clé API a les autorisations nécessaires avant d'exécuter des ordres de marge.

Comment gérer les temps d'arrêt de l'API ou les échecs? Implémentez la logique de réessayer avec le revers exponentiel pour les demandes échouées. Surveillez la page d'état officielle de Kucoin et abonnez-vous à leurs annonces système. Utilisez des modèles de disjoncteur dans les applications de production pour empêcher les échecs en cascade pendant les pannes.

L'authentification à deux facteurs est-elle requise pour utiliser l'API? Bien que 2FA ne soit pas requis pour les appels API, il est fortement recommandé pour la sécurité du compte. Les touches API contournent 2FA, donc les sécuriser correctement est essentiel pour empêcher l'accès non autorisé aux fonds.