KuCoin – Guide d'importation d'API
Ce guide explique comment créer et lier une clé API KuCoin à votre plateforme de trading.
En connectant votre compte KuCoin via l'API, vous pouvez activer le trading automatisé, l'exécution de stratégie et la synchronisation de compte en temps réel en toute sécurité.
⚠️ Remarques importantes avant de commencer
Avant de créer une clé API KuCoin, veuillez noter :
- Le système de clé API de KuCoin nécessite Clé, Secret et Passphrase — les trois doivent être enregistrés en toute sécurité, car le Secret ne peut pas être récupéré une fois perdu.
- Les clés API avec autorisations de trading mais aucune liste blanche IP peuvent être automatiquement désactivées ou supprimées après 30 jours d'inactivité.
- Pour activer efficacement les API pour le trading/les robots, vous devez activer les autorisations et éventuellement utiliser la liste blanche IP.
- Assurez-vous que l'Authentification à deux facteurs (2FA) est activée sur votre compte pour la création d'API.
Étape 1 : Connectez-vous à KuCoin
- Visitez le site officiel de KuCoin
👉 https://www.kucoin.com - Connectez-vous avec vos identifiants (email/téléphone + mot de passe)
- Assurez-vous que 2FA (Google Authenticator / SMS) est activé
📸 Exemple de capture d'écran
Étape 2 : Accédez à la gestion des API
- Cliquez sur votre avatar de profil (coin supérieur droit)
- Sélectionnez Gestion des API dans la liste déroulante.
📸 Exemple de capture d'écran
Étape 3 : Créer une nouvelle clé API
- Cliquez sur le bouton Créer une API
- Dans la fenêtre contextuelle, saisissez :
- Nom de l'API (par exemple,
UFOX‑KuCoin‑API) - Phrase secrète API — elle est distincte de votre mot de passe de connexion et sera utilisée lors de la connexion à l'API
- Nom de l'API (par exemple,
- Complétez l'invite et continuez
📸 Exemple de capture d'écran
💡 La phrase secrète de l'API est cruciale : vous en aurez besoin lors de la liaison de l'API sur votre plateforme.
Étape 4 : Configurer les autorisations de l'API
Sur la page de création d'API, choisissez les autorisations appropriées en fonction de vos besoins de trading :
✅ Autorisations recommandées pour le trading
- ☑️ Général – permet d'interroger des informations sur le marché et le compte (lecture seule)
- ☑️ Trade – permet de passer et d'annuler des ordres (spot, futures)
- (Facultatif) ☑️ Margin Trade – permet le trading sur marge
- (Facultatif & ⚠️) ☑️ Transfert – permet le transfert et le retrait d'actifs (à utiliser avec prudence)
⚠️ Les autorisations de retrait/transfert ne doivent être activées qu'en cas d'absolue nécessité et avec une liste blanche IP stricte.
Étape 5 : Activer la liste blanche IP (recommandé)
- Basculez Restriction IP sur Oui
- Ajoutez les adresses IP de confiance fournies par votre plateforme de trading
- Cliquez sur Ajouter ou Enregistrer
Les clés API avec des autorisations de trading et aucune adresse IP sur liste blanche peuvent automatiquement perdre l'accès au trading ou être supprimées après 30 jours d'inactivité.
Étape 6 : Vérification de sécurité
Après avoir défini les autorisations :
- Entrez votre Mot de passe de trading
- Entrez le Code de vérification de l'e-mail
- Entrez le code 2FA
- Confirmez la création de l'API
Une fois terminé, KuCoin affichera :
- Clé API
- Clé secrète
- Phrase secrète (celle que vous avez saisie plus tôt)
⚠️ Enregistrez la clé secrète et la phrase secrète dans un emplacement sécurisé ; ils ne seront plus affichés.
Étape 7 : Liez la clé API sur votre plateforme de trading
- Accédez à Compte → Gestion des API sur votre plateforme
- Sélectionnez KuCoin comme échange
- Saisissez :
- Clé API
- Clé secrète
- Phrase secrète
- Choisissez les étendues souhaitées :
- Spot / Futures / Marge
- Cliquez sur ** Lier/Connecter **
Étape 8 : Vérifier l'état de la connexion à l'API
Une fois la liaison terminée, vous devriez voir :
- ✅ Statut API : Connecté
- 📊 Équilibrage et synchronisation du compte
- 🤖 Stratégies de trading disponibles
Erreurs courantes et comment les corriger
❌ API ou secret invalide
- Assurez-vous d'avoir copié correctement la clé API, le secret et la phrase secrète.
- Supprimez tous les espaces lors du collage
- Recréez la clé API si le secret est perdu
❌ Autorisation refusée
- Vérifiez que les autorisations requises sont activées (par exemple, Trade)
- Les stratégies à terme nécessitent des autorisations Futures/Derivatives
❌ Erreur de liste blanche
- Assurez-vous que les bonnes adresses IP de la plate-forme figurent dans la liste blanche
- Pour les tests, vous pouvez désactiver temporairement la restriction IP
Bonnes pratiques de sécurité
- 🔐 Utilisez IP Whitelisting pour limiter l'accès
- 🔄 Faites pivoter fréquemment les clés API
- 🚫 Désactivez les autorisations inutiles (notamment les retraits)
- 🛑 Supprimez immédiatement les clés API inutilisées ou compromises
##FAQ
Quelle est la phrase secrète de l'API ?
Il s'agit d'un mot de passe défini par l'utilisateur, requis ainsi que de la clé et du secret lors de l'authentification des requêtes API KuCoin.
Puis-je modifier les autorisations de l'API plus tard ?
Oui — les autorisations et les adresses IP sur liste blanche peuvent être mises à jour à tout moment via la page de gestion des API.
L'API va-t-elle expirer ?
Les clés API avec le trading activé mais sans IP sur liste blanche peuvent être désactivées après inactivité. Les clés sur liste blanche restent généralement actives.
🎯 Terminé
Votre API KuCoin est maintenant créée et connectée avec succès.
Vous pouvez désormais démarrer le trading automatisé et la synchronisation des données en temps réel en toute sécurité.
Pour plus de guides d’importation d’API, veuillez consulter d’autres documentations d’échange.