Bybit garde un long historique de trades : son API remonte environ deux ans. C'est la connexion qui offre le plus d'historique dès le premier jour. Vous créez une clé en lecture seule une fois, vous la collez dans SetupBook, et vos trades perpétuels USDT et spot arrivent tout seuls. 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 tradez aussi sur Binance, voir le guide Binance.

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 Bybit. Créez la clé sur le site de Bybit ; le centre d'aide de Bybit dit que les clés ne peuvent pas être créées dans l'application.
  • Cinq minutes.

La clé ne fait que lire. Vous choisissez Read-Only et vous laissez désactivées toutes les autorisations de trade, d'ordre et de transfert. SetupBook ne passe jamais d'ordre et ne déplace jamais d'argent. Il stocke la clé chiffrée 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 Bybit, cliquez sur l'icône de votre compte en haut à droite, choisissez API, ouvrez API Management et appuyez sur Create New Key. Choisissez System-generated API Keys : Bybit fabrique la clé et le secret pour vous, et ce sont les deux choses que SetupBook demande. Donnez à la clé un nom que vous reconnaîtrez, par exemple SetupBook.

Un dessin de Bybit API Management avec le bouton Create New Key, Read-Only sélectionné et toute autorisation de trade, d'ordre ou de transfert laissée décochée
API Management : créez une clé System-generated, choisissez Read-Only, laissez les autorisations de trade désactivées.

2. Choisir Read-Only

Dans les autorisations, choisissez Read-Only. N'en cochez aucune qui trade, passe des ordres ou déplace des fonds. Une clé en lecture seule est tout ce qu'il faut à un journal.

Restriction d'IP : 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 sous les connexions. Avec une clé en lecture seule, rien ne peut être tradé ni retiré dans les deux cas. Une chose à savoir : Bybit désactive une clé sans restriction d'IP au bout de 90 jours. Quand cela arrive, créez une nouvelle clé et utilisez Remplacer la clé (voir plus bas).

3. Copier la clé API et le secret

Confirmez avec votre contrôle de sécurité. Bybit affiche la clé API et le secret. Copiez les deux tout de suite dans un endroit sûr, comme un gestionnaire de mots de passe. Les exchanges n'affichent généralement le secret qu'une fois : si vous le perdez, créez une nouvelle clé.

4. Les coller dans SetupBook

Dans SetupBook, ouvrez Comptes → Connexions et appuyez sur Ajouter une connexion. Choisissez Bybit, laissez Environnement sur Réel, collez la clé dans Clé API et le secret dans Secret API.

Sous Marchés, cochez ce que vous tradez : Perpétuels USDT et Spot. Bybit n'a pas besoin de liste de paires : SetupBook trouve les symboles depuis vos exécutions. Laissez Dans le compte sur Créer depuis le compte de la plateforme, ou choisissez l'un de vos comptes, puis appuyez sur Vérifier la clé et connecter.

La fenêtre de connexion Bybit de SetupBook avec les champs clé API et secret et les marchés mis en évidence
Comptes → Connexions → Ajouter une connexion → Bybit. Clé, secret et marchés.

SetupBook vérifie d'abord la clé auprès de Bybit. Si la clé peut faire plus que lire, il vous prévient ; supprimez cette clé chez Bybit et créez-en une en lecture seule.

5. Suivre la première synchro

La première synchro démarre aussitôt et récupère tout ce que Bybit sert encore, soit environ deux ans. 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.

Une carte de connexion Bybit dans SetupBook avec le statut Active mis en évidence, l'heure de la dernière synchro et le 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.
  • Champs verrouillés. Symbole, sens, heures, prix, taille, frais et résultat net viennent de Bybit 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 Bybit 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.

Demo Trading

Bybit Demo Trading est son propre compte, avec son propre identifiant d'utilisateur. Chez Bybit, passez sur Demo Trading, survolez votre avatar, ouvrez API là-bas et créez une clé. Dans SetupBook, choisissez Démo dans la case Environnement et collez cette clé. Ses trades arrivent dans un compte Démo. N'utilisez pas le site testnet séparé de Bybit : c'est autre chose. Bybit ne garde les ordres démo que 7 jours, connectez-vous donc tôt si vous voulez les conserver.

Remplacer une clé

Ouvrez le menu de la connexion, choisissez Modifier et appuyez sur Remplacer la clé. Collez la nouvelle clé et le secret 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
L'exchange a rejeté la clé. La clé ou le secret a été mal recopié, ou la clé a été supprimée Recopiez-les depuis Bybit, ou créez une nouvelle clé
Une clé démo ne marche pas Réel est sélectionné Choisissez Démo dans la case Environnement, ou l'inverse pour une clé réelle
Cette clé peut trader (un avertissement) Une autorisation de trade, d'ordre ou de transfert est activée Créez une nouvelle clé Read-Only, puis utilisez Remplacer la clé
Le statut est passé à Erreur après quelques mois Une clé sans restriction d'IP s'arrête après 90 jours Créez une nouvelle clé et remplacez-la
Des trades spot manquent Spot n'est pas coché Modifiez la connexion et cochez le marché
Des trades perpétuels manquent Le contrat est coin-margined Les contrats coin-margined ne sont pas encore pris en charge

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é Read-Only ne peut ni passer d'ordre ni retirer, et SetupBook n'a aucun code qui essaie. La clé est stockée chiffrée sur le serveur et n'est jamais envoyée à votre navigateur. Si vous voulez arrêter, supprimez la clé chez Bybit et la connexion s'arrête simplement.

Dois-je restreindre l'adresse IP ?

Non. Laissez la restriction d'IP 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.

Jusqu'où remontent mes trades ?

Environ deux ans à la première synchro. Si votre historique est plus ancien, il doit arriver en fichier : si vous pouvez l'exporter de Bybit en CSV, l'option Autre CSV de l'import fait correspondre ses colonnes (voir le guide d'import).

Quels marchés Bybit sont lus ?

Les perpétuels USDT et le spot. Les contrats coin-margined et les paiements de funding ne sont pas encore lus.

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 OKX.