# Connecter KuCoin à SetupBook avec une clé API à permission General et synchroniser vos trades

> Créez une clé API KuCoin avec la seule permission General, ajoutez sa passphrase dans SetupBook et vos trades futures USDT-M et spot arrivent dans le journal.

- Source: https://setupbook.io/fr/blog/connecter-kucoin-journal-de-trading
- Site: SetupBook
- Language: fr
- Published: 2026-10-30
- Tags: synchronisation, kucoin, outils
- en: https://setupbook.io/blog/connect-kucoin-trading-journal
- tr: https://setupbook.io/tr/blog/kucoin-islem-gunlugu-baglama
- es: https://setupbook.io/es/blog/conectar-kucoin-diario-de-trading
- pt: https://setupbook.io/pt/blog/conectar-kucoin-diario-de-trades
- id: https://setupbook.io/id/blog/menghubungkan-kucoin-jurnal-trading
- vi: https://setupbook.io/vi/blog/ket-noi-kucoin-nhat-ky-giao-dich
- de: https://setupbook.io/de/blog/kucoin-mit-trading-tagebuch-verbinden
- ar: https://setupbook.io/ar/blog/connect-kucoin-trading-journal

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](https://setupbook.io/fr/blog/connecter-metatrader-ctrader-bybit-binance-okx-journal-de-trading). Si vous utilisez aussi MEXC, voir [le guide MEXC](https://setupbook.io/fr/blog/connecter-mexc-journal-de-trading).

## 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](https://setupbook.io/fr/signup).
- 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](https://setupbook.io/blog/connect/kucoin-api-key-general-permission.svg)

*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](https://setupbook.io/blog/connect/setupbook-kucoin-connection-dialog.fr.svg)

*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](https://setupbook.io/blog/connect/setupbook-kucoin-connection-active-status.fr.svg)

*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](https://setupbook.io/fr/glossary/resultat-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](https://setupbook.io/fr/guide). Pour connecter un autre exchange, lisez [le guide Hyperliquid](https://setupbook.io/fr/blog/connecter-hyperliquid-journal-de-trading).