KuCoin n'a pas d'interrupteur « lecture seule ». Sa clé en lecture seule est celle qui a la permission General et rien d'autre. SetupBook lit vos exécutions avec une telle clé, de sorte que vos trades futures USDT-M et spot arrivent dans votre journal sans rien taper. KuCoin demande aussi une passphrase quand vous créez la clé, et SetupBook en a besoin. Cela prend environ cinq minutes.

Ce guide montre chaque étape en images. Pour la façon dont toutes les plateformes se connectent, lisez le tour d'horizon de toutes les connexions. Si vous utilisez aussi MEXC, voir le guide MEXC.

Avant de commencer

  • Un compte SetupBook avec Pro. Connecter une plateforme fait partie de Pro, et chaque journal commence avec 14 jours de Pro : commencez 14 jours gratuits.
  • Un compte KuCoin. KuCoin demande un contrôle de sécurité quand vous créez une clé : votre mot de passe de trading, plus un code de votre e-mail et de votre application d'authentification.
  • Un endroit où noter la passphrase, comme un gestionnaire de mots de passe.
  • Cinq minutes.

La clé ne fait que lire. Vous cochez General et vous laissez Spot, Futures, Margin, Earn et Withdrawal décochés. SetupBook ne passe jamais d'ordre et ne déplace jamais d'argent. Il stocke la clé et la passphrase chiffrées sur le serveur et s'en sert pour lire vos exécutions.

1. Ouvrir API Management et créer une clé

Sur le site de KuCoin, cliquez sur votre avatar, choisissez API Management et appuyez sur Create API. KuCoin demande à quoi sert la clé : choisissez API Trading, l'option qui crée une clé à vous. Tapez ensuite un API name (appelez-la SetupBook) et une API passphrase.

Dessin du formulaire Create API de KuCoin : seule General cochée, Spot, Futures et Withdrawal décochées
Create API : un nom, une passphrase à vous, General coché, tout le reste décoché.

2. Cocher General et rien d'autre

À l'étape des permissions, cochez General. KuCoin la décrit comme limitée aux actions en lecture seule : informations du compte, relevés et informations sur les ordres. Laissez Spot, Futures, Margin, Earn et Withdrawal décochés, ainsi que toute autre case. Les mots du formulaire peuvent différer un peu d'une région à l'autre (le site européen appelle cette étape API Restrictions), cherchez donc la case General.

Restriction d'IP : l'aide de KuCoin dit qu'une clé qui trade doit être liée à une adresse IP. La vôtre ne trade pas, laissez donc la restriction désactivée. Si le formulaire en exige une quand même, demandez-nous avec le formulaire de retour sous les connexions : nous ne pouvons pas encore vous donner d'adresse fixe à autoriser. Avec une clé en lecture seule, rien ne peut être tradé ni retiré dans les deux cas.

3. Copier la clé, le secret et la passphrase

Confirmez le contrôle de sécurité. KuCoin affiche la clé API et le secret. Copiez les deux dans un endroit sûr, avec votre passphrase. KuCoin ne peut récupérer aucun des trois une fois perdu : si vous en perdez un, créez une nouvelle clé.

4. Coller les trois dans SetupBook

Dans SetupBook, ouvrez Comptes → Connexions et appuyez sur Ajouter une connexion. Choisissez KuCoin. Collez la clé dans Clé API, le secret dans Secret API et la passphrase dans Passphrase.

Sous Marchés, cochez ce que vous tradez : Perpétuels USDT (futures USDT-M) et Spot. Pour le spot, KuCoin n'a pas d'appel « qu'ai-je tradé » : écrivez les paires que vous tradez dans Paires spot, séparées par des virgules, par exemple BTC-USDT, ETH-USDT. Les paires des coins que vous détenez s'ajoutent toutes seules. Les futures n'ont pas besoin de liste.

Laissez Dans le compte sur Créer depuis le compte de la plateforme, ou choisissez l'un des vôtres, puis appuyez sur Vérifier la clé et connecter.

SetupBook : fenêtre de connexion KuCoin avec clé API, secret, passphrase, marchés et paires spot
Comptes → Connexions → Ajouter une connexion → KuCoin. Clé, secret, passphrase, marchés et paires spot.

KuCoin ne dit pas à une clé quelles sont ses permissions, SetupBook ne peut donc pas vous prévenir si vous avez coché une case de trading par erreur. Regardez une fois les permissions de la clé chez KuCoin pour en être sûr.

5. Suivre la première synchro

La première synchro démarre aussitôt. Les futures remontent environ trois mois ; le spot est lu paire par paire aussi loin que KuCoin le sert. Quand elle est finie, la connexion affiche Active, l'heure de la dernière synchro et le nombre de trades. Ensuite SetupBook cherche de nouvelles exécutions chaque heure, et vous pouvez appuyer sur Synchroniser à tout moment.

SetupBook : carte de connexion KuCoin au statut Active, avec dernière synchro et nombre de trades
Statut Active, dernière synchro et nombre de trades après la première synchro.

Ce que vous obtenez :

  • Des positions, pas des exécutions en vrac. Les exécutions sont regroupées en positions comme dans l'import de fichier : une position fermée en trois fois est un seul trade avec trois sorties.
  • Taille du contrat. Un contrat futures vaut une quantité fixe du coin (le contrat BTC XBTUSDTM vaut 0,001 BTC), et SetupBook l'utilise, donc la taille et le résultat correspondent à KuCoin.
  • Champs verrouillés. Symbole, sens, heures, prix, taille, frais et résultat net viennent de KuCoin et restent exacts (ils alimentent votre résultat net). Plan, qualité du setup, erreurs, notes et captures d'écran restent à vous.
  • Fuseau horaire. Les heures de KuCoin sont en UTC, il n'y a donc rien à régler.
  • Non inclus. Les contrats coin-margined (inverses) et les paiements de funding ne sont pas lus.

Démo ou réel

SetupBook ne connecte que les comptes réels de KuCoin. KuCoin n'a pas de trading démo que SetupBook puisse lire.

Remplacer une clé

Ouvrez le menu de la connexion, choisissez Modifier et appuyez sur Remplacer la clé. Collez la nouvelle clé, le secret et la passphrase et enregistrez : SetupBook les vérifie, oublie les anciens et utilise les nouveaux dès la synchro suivante. Les trades restent.

Problèmes

Ce que vous voyez Pourquoi Que faire
Les clés OKX, Bitget et KuCoin ont besoin de leur passphrase. Le champ passphrase est vide Collez la passphrase que vous avez tapée en créant la clé
L'exchange a rejeté la clé. Une mauvaise passphrase, un secret mal recopié, ou une clé supprimée Vérifiez les trois valeurs, ou créez une nouvelle clé
Vous avez oublié la passphrase KuCoin ne peut pas la récupérer Créez une nouvelle clé et utilisez Remplacer la clé
Des trades spot manquent La paire n'est pas dans votre liste Modifiez la connexion et ajoutez la paire dans Paires spot
Des trades futures manquent Perpétuels USDT n'est pas coché, ou le contrat est coin-margined Cochez le marché ; les contrats coin-margined sont ignorés
Rien n'arrive et le statut est Erreur La clé a été supprimée chez KuCoin Créez une nouvelle clé et remplacez-la

Un souci de connexion ? Écrivez-nous depuis la page des connexions, avec ce que vous avez essayé. Nous répondons par e-mail sous 30 minutes, tous les jours.

Questions fréquentes

Est-ce sûr ? SetupBook peut-il trader ou retirer ?

Non. Une clé avec seulement General ne peut ni passer d'ordre ni retirer, et SetupBook n'a aucun code qui essaie. La clé et la passphrase sont stockées chiffrées sur le serveur et ne sont jamais envoyées à votre navigateur. Pour arrêter, supprimez la clé chez KuCoin et la connexion s'arrête.

Pourquoi SetupBook a-t-il besoin de la passphrase ?

KuCoin signe chaque requête avec la passphrase en plus de la clé et du secret. Sans elle, KuCoin rejette la requête. Vous avez choisi la passphrase vous-même en créant la clé.

Dois-je restreindre l'adresse IP ?

Non. Laissez-la désactivée. Nous ne pouvons pas encore vous donner d'adresse fixe à autoriser ; si vous en voulez une, demandez-la-nous avec le formulaire de retour. Une clé en lecture seule ne peut ni trader ni retirer, avec ou sans règle d'IP.

Pourquoi dois-je lister mes paires spot ?

KuCoin n'a aucun appel qui renvoie les paires spot que vous avez tradées. Vous listez les paires, et SetupBook ajoute par-dessus les paires des coins que vous détenez. Les futures n'ont pas besoin de liste.

Est-ce payant ?

Connecter une plateforme fait partie de Pro. Chaque journal commence avec 14 jours de Pro, et rien n'est prélevé pendant ces 14 jours. Annulez avant la fin et vous restez sur le plan gratuit, qui garde la saisie à la main.

Vous préférez un fichier ? L'import fonctionne toujours : voir le guide d'utilisation. Pour connecter un autre exchange, lisez le guide Hyperliquid.