Connecter Bybit à Freya
Bybit est le seul exchange où Freya peut configurer la connexion pour vous. Freya est un broker Bybit enregistré, ce qui signifie que Bybit crée la clé API de son côté, y attache les bonnes permissions et la remet directement à Freya — vous ne voyez jamais de clé, ne copiez jamais de secret et n'ajoutez jamais d'adresse IP à une liste blanche.
Cette voie s'appelle la Connexion rapide. L'ancienne voie, où vous créez la clé vous-même sur Bybit, existe toujours et fonctionne toujours. Ce guide couvre les deux, ainsi que quoi faire lorsque vous devez remplacer une clé ou lorsqu'une connexion échoue.
Key Takeaways
- La Connexion rapide tient en un clic : vous approuvez Freya sur Bybit, et vos clés Spot et Futures sont ajoutées automatiquement.
- La Connexion rapide ne nécessite aucune liste blanche d'IP — Bybit lie elle-même la clé aux serveurs de Freya, ce qui explique aussi pourquoi elle n'expire pas.
- La Connexion manuelle fonctionne toujours et reste la seule voie sur Binance et OKX.
- Quelle que soit la voie choisie, la clé ne reçoit jamais la permission de retrait. Freya ne peut pas déplacer vos fonds.
- Se connecter une seconde fois ne crée pas de doublons — Bybit émet une clé par plateforme et par compte, donc cela rafraîchit ce que vous avez déjà.
Avant de commencer
Deux choses valent la peine d'être vérifiées d'abord.
Approvisionnez le compte que vous connectez. Un bot ne peut pas ouvrir de position sur un solde vide, et Freya connectera volontiers une clé qui n'a rien à trader. Si vous prévoyez de faire tourner des bots futures, assurez-vous que les fonds se trouvent sur le compte que vos bots utiliseront.
Utilisez un navigateur. Les deux voies fonctionnent sur les navigateurs desktop et mobiles. Créer une clé API à la main est une tâche réservée au navigateur côté Bybit — leur application mobile n'expose pas l'écran des clés API.
Connexion rapide
C'est la voie que nous recommandons. Elle prend environ quinze secondes si vous êtes déjà connecté à Bybit.
- Dans Freya, ouvrez Paramètres → Clés API et sélectionnez Ajouter une clé API.
- Choisissez Bybit comme exchange. L'onglet Connexion rapide est déjà sélectionné.
- Sélectionnez Connecter avec Bybit. Un onglet Bybit s'ouvre.
- Connectez-vous à Bybit. Si vous n'avez pas encore de compte, vous pouvez en créer un sur place et revenir — la connexion vous attend.
- Vérifiez et approuvez. Bybit vous montre exactement ce que Freya demande. L'approbation est la seule étape qui accorde quoi que ce soit.
- L'onglet se ferme de lui-même et vos clés apparaissent dans Freya, prêtes à l'emploi.
Une seule approbation couvre à la fois le Spot et les Futures. Vous ne répétez pas l'opération par marché.
Ce qui se passe en coulisses
Lorsque vous approuvez, Bybit crée une clé API liée à l'enregistrement de broker de Freya et l'envoie directement aux serveurs de Freya. Comme elle arrive de cette façon, elle ne passe jamais par votre navigateur, votre presse-papiers ou une capture d'écran — c'est ainsi que les clés API fuitent le plus souvent.
Bybit lie aussi cette clé aux serveurs de Freya de son propre chef. Deux conséquences dont vous bénéficiez :
- Pas de liste blanche d'IP. Il n'y a rien à copier ou coller dans les paramètres de Bybit.
- La clé n'expire pas. Une clé créée à la main peut expirer ; une clé liée via le broker, non.
Si vous changez d'avis
Refuser sur l'écran de Bybit est totalement sans danger. Rien n'est créé sur Bybit et rien ne change dans Freya — vous verrez simplement que l'autorisation n'a pas été complétée, et vous pourrez réessayer quand vous le souhaitez.
Fermer l'onglet Bybit sans décider a le même effet.
Remplacer une clé Bybit
Parfois vous avez besoin d'une nouvelle clé — vous avez révoqué l'ancienne sur Bybit, vous passez à un autre compte Bybit, ou le support vous a demandé de vous reconnecter.
Avec la Connexion rapide, reconnectez-vous simplement. Ouvrez Paramètres → Clés API → Ajouter une clé API, choisissez Bybit, et sélectionnez Connecter avec Bybit comme avant. Bybit émet une clé par plateforme et par compte, donc la reconnexion rafraîchit ce que vous avez déjà au lieu d'empiler une seconde copie. Vos bots existants continuent de tourner sur l'identifiant rafraîchi.
Si vous avez d'abord supprimé la clé côté Bybit, la reconnexion est aussi la solution — Bybit en émettra une nouvelle à l'approbation.
⚠️ Ne supprimez pas votre clé Freya pendant que des bots tournent, sauf si vous avez l'intention de les arrêter. Un bot en cours d'exécution sans identifiant fonctionnel ne peut pas gérer la position qu'il a déjà ouverte. Arrêtez ou fermez d'abord vos bots, puis reconnectez-vous.
Connexion manuelle
Utilisez cette voie si vous préférez créer la clé vous-même, ou si vous connectez un sous-compte Bybit.
Créer la clé sur Bybit
- Connectez-vous à Bybit dans un navigateur et ouvrez la section API de votre compte.
- Créez une clé API générée par le système (System-generated).
- Choisissez API Transaction comme type d'utilisation — pas la lecture seule.
- Accordez les permissions Contract Trade et Spot Trade, ainsi que l'accès en lecture.
- N'accordez jamais le retrait (Withdrawal). Freya n'en a pas besoin et ne peut pas l'utiliser.
- Restreignez la clé par IP et saisissez l'adresse de Freya, que la fenêtre vous montre et vous laisse copier.
⚠️ Bybit n'affiche votre secret qu'une seule fois. Copiez-le avant de fermer cet écran. Si vous le perdez, la clé ne peut pas être récupérée — vous devrez en créer une nouvelle.
Ajouter la clé à Freya
- Dans Freya, ouvrez Paramètres → Clés API → Ajouter une clé API et choisissez Bybit.
- Passez à l'onglet Connexion manuelle.
- Collez la clé API et le secret, et donnez à la clé un nom que vous reconnaîtrez plus tard.
- Sélectionnez Ajouter une clé API. Freya valide immédiatement la connexion et les permissions.
Si la validation échoue, Freya vous dit exactement quelle partie a échoué plutôt qu'une erreur générique. Consultez Impossible de connecter votre exchange ? Corriger les erreurs de connexion de clé API pour chaque message et sa solution.
Questions fréquentes
Quelle voie devrais-je utiliser ?
La Connexion rapide, sauf raison particulière de ne pas le faire. Elle compte moins d'étapes, ne peut pas échouer sur une faute de frappe, et supprime entièrement la liste blanche d'IP. La Connexion manuelle existe pour ceux qui veulent créer et contrôler la clé eux-mêmes, et pour les sous-comptes.
La Connexion rapide donne-t-elle à Freya plus d'accès qu'une clé manuelle ?
Non. Les deux voies produisent une clé de trading avec la même portée : lecture et trading, jamais le retrait. La différence tient à qui fait la configuration, pas à ce que la clé peut faire.
Dois-je ajouter une adresse IP à une liste blanche ?
Seulement avec la Connexion manuelle. Avec la Connexion rapide, Bybit lie automatiquement la clé aux serveurs de Freya, ce qui explique aussi pourquoi cette clé n'expire pas.
Puis-je connecter le Spot et les Futures Bybit séparément ?
Avec la Connexion rapide, vous n'en avez pas besoin — une seule approbation configure les deux. Avec la Connexion manuelle, vous pouvez ajouter des clés séparées si vous préférez garder les marchés distincts.
Que se passe-t-il si je me connecte deux fois ?
Rien ne casse et rien ne se duplique. Bybit émet une clé par plateforme et par compte, donc une seconde connexion rafraîchit la clé existante.
Puis-je utiliser la Connexion rapide avec un sous-compte Bybit ?
Utilisez la Connexion manuelle pour les sous-comptes. La Connexion rapide est destinée à votre compte Bybit principal.
Ma clé est-elle en sécurité une fois dans Freya ?
Elle est chiffrée dès son arrivée et n'est plus jamais affichée — ni à vous, ni au support. La supprimer dans Freya retire l'identifiant stocké, et la révoquer sur Bybit coupe l'accès de l'autre côté. Pour la vue d'ensemble, consultez Mon argent est-il en sécurité sur Freya Finance ?.
Freya dit que ma clé est invalide juste après la connexion. Pourquoi ?
Le plus souvent, la clé a été créée sans permission de trading, ou elle a été restreinte à une IP qui n'est pas celle de Freya. Avec la Connexion rapide, ni l'un ni l'autre ne peut se produire, donc se reconnecter par cette voie est généralement la solution la plus rapide.
Lectures associées
- Connexion rapide à Bybit : la configuration en un clic expliquée
- Comment connecter votre exchange à Freya Finance — le guide général, qui couvre aussi Binance et OKX
- Impossible de connecter votre exchange ? Corriger les erreurs de connexion de clé API
- Sécurité des API d'Exchange et Atténuation des Risques
