Comment utiliser l'API KuCoin pour les robots de trading ? (Outils de développement)

Mécanisme d'authentification

1. L'API KuCoin nécessite la génération de signature HMAC-SHA256 pour tous les points de terminaison privés. La signature est dérivée d'une concaténation d'horodatage, de méthode HTTP, de chemin de point de terminaison et de corps de requête facultatif.

2. Chaque demande doit inclure trois en-têtes : KC-API-KEY , KC-API-TIMESTAMP et KC-API-SIGN . L'horodatage doit être inférieur à 5 secondes de l'heure du serveur de KuCoin.

3. La paire de clés API doit être générée à partir de l'interface utilisateur KuCoin sous Gestion des API. Les autorisations doivent être limitées aux seules portées nécessaires telles que « Échange », « Compte » ou « Retrait ».

4. Les clés secrètes ne sont jamais transmises par fil. Ils restent locaux dans l’environnement du bot et sont utilisés uniquement pour signer les requêtes sortantes.

5. La liste blanche IP est appliquée par défaut pour les clés API nouvellement créées. Les développeurs doivent enregistrer les adresses IP de confiance à l'avance pour éviter les réponses 401 non autorisées.

Gestion du cycle de vie des commandes

1. Passer une commande utilise le point de terminaison POST /api/v1/orders avec des paramètres tels que le symbole, le côté (achat/vente), le type (limite/marché/stop) et la taille ou le prix.

2. Les ordres au marché ne nécessitent que la taille et le côté ; les ordres limités imposent à la fois le prix et la taille. Les ordres stop introduisent des champs supplémentaires tels que stopPrice et stop.

3. Les commandes actives peuvent être interrogées via GET /api/v1/orders?status=active , renvoyant des résultats paginés avec les ID de commande, le statut, la taille remplie et la taille restante.

4. L'annulation d'une seule commande utilise DELETE /api/v1/orders/{order-id} , tandis que l'annulation groupée cible plusieurs identifiants à l'aide de DELETE /api/v1/orders?symbol=BTC-USDT .

5. L'état d'exécution des ordres est suivi via les flux WebSocket ou en interrogeant le point de terminaison GET /api/v1/fills , qui renvoie l'historique des transactions, y compris les montants des frais et les horodatages.

Intégration des données de marché

1. Les données publiques des tickers sont récupérées via GET /api/v1/market/orderbook/level2_20?symbol=BTC-USDT , fournissant les 20 principaux niveaux d'offre/vente avec le prix, la taille et le numéro de séquence.

2. Les mises à jour en temps réel sont prises en charge via le canal WebSocket v2 de KuCoin /market/ticker:{symbol} , où les clients s'abonnent à l'aide de messages JSON contenant des indicateurs de sujet et de privateChannel.

3. Les données historiques kline sont récupérées avec GET /api/v1/market/candles?symbol=ETH-USDT&interval=1min&startAt=1698777600&endAt=1698781200 , prenant en charge des intervalles de 1 minute à 1 jour.

4. La liste des symboles et les détails des paires de négociation sont disponibles sur GET /api/v2/symbols , y compris les contraintes baseCurrency, quoteCurrency, priceIncrement et minSize.

5. Les instantanés de profondeur incluent des numéros de séquence permettant la synchronisation delta. Les clients doivent valider la continuité de la séquence pour éviter les mises à jour manquées ou les états obsolètes du carnet de commandes.

Limitation du débit et gestion des erreurs

1. KuCoin applique des limites de débit strictes : 100 requêtes par seconde pour les points de terminaison publics et 20 par seconde pour les points de terminaison privés sur les clés API standard.

2. Le dépassement des limites déclenche des réponses HTTP 429 avec des en-têtes Retry-After indiquant la durée d'attente obligatoire en millisecondes.

3. Les codes d'erreur courants incluent 400 (paramètre invalide), 401 (échec d'authentification), 403 (autorisations insuffisantes) et 404 (symbole introuvable).

4. Toutes les réponses d'erreur contiennent des corps JSON standardisés avec des champs de code, de message et parfois de suggestion, par exemple {'code':'400100','msg':'Invalid symbol'} .

5. Des clés d'idempotence sont requises pour la passation des commandes afin d'éviter les soumissions en double ; il doit s'agir d'UUID uniques envoyés dans l'en-tête KC-API-REQ-ID .

Foire aux questions

Q : Puis-je utiliser la même clé API sur plusieurs instances de bot ? R : Oui, mais les demandes simultanées dépassant les limites de débit entraîneront une limitation. Les clés partagées augmentent également les risques de sécurité si elles sont compromises.

Q : Pourquoi ma demande signée renvoie-t-elle une « signature invalide » même avec un horodatage et un secret corrects ? R : Le plus souvent, cela est dû à une canonisation incorrecte de la chaîne : caractères de nouvelle ligne manquants entre les composants, codage UTF-8 incorrect du corps de la requête ou espaces de fin dans la chaîne de préhachage.

Q : Les connexions WebSocket prennent-elles en charge la reconnexion avec la resynchronisation de l'état ? R : Oui, KuCoin fournit des numéros de séquence dans chaque message. Lors de la reconnexion, les clients doivent demander un nouvel instantané et supprimer tous les messages dont les numéros de séquence sont inférieurs au dernier traité.

Q : Le trading sur marge ou à terme est-il pris en charge via la même API REST ? R : Non. Les opérations sur marge et à terme nécessitent des bases d'API distinctes : https://api.kucoin.com/api/v1/margin et https://futures.kucoin.com/api/v1/contracts/active , chacune avec une authentification et des points de terminaison distincts.