Avant qu'un bot puisse trader pour vous, Freya a besoin d'une connexion à l'exchange où se trouvent vos fonds — Binance, OKX ou Bybit. Vous ne déplacez pas vos fonds et ne partagez pas votre mot de passe pour cela. À la place, vous créez une clé API : un identifiant restreint qui permet à Freya de passer des ordres en votre nom, tandis que votre argent reste sur votre propre compte d'exchange.
Ce guide explique précisément quelles permissions accorder (et lesquelles ne jamais accorder), comment ajouter la clé à Freya, et quoi faire si la connexion ne se valide pas. Si vous voulez la vue d'ensemble sur pourquoi c'est sûr, lisez d'abord Mon argent est-il en sécurité sur Freya Finance ?.
Points clés
- Vous connectez un exchange avec une clé API — un identifiant restreint — et non en déplaçant des fonds ou en partageant le mot de passe de votre exchange.
- La clé a besoin des permissions de lecture et de trading Spot et/ou Futures. Elle ne doit JAMAIS avoir la permission de retrait.
- Les clés OKX nécessitent une phrase secrète que vous définissez à leur création ; ce n'est pas le cas de Binance ni de Bybit.
- Ajoutez la clé dans Freya sous Paramètres → Clés API → Ajouter une clé API, et Freya la valide instantanément.
- Si la validation échoue, Freya vous dit exactement pourquoi — clé invalide, IP non autorisée, ou permission manquante — et chaque cas a une solution simple.
Un aperçu rapide des étapes
- Créez une clé API sur votre exchange avec les permissions de lecture et de trading, mais pas de retrait.
- Copiez les identifiants — la clé API, le secret, et (pour OKX) la phrase secrète.
- Ajoutez la clé à Freya sous Paramètres → Clés API → Ajouter une clé API, et sélectionnez votre exchange.
- Laissez Freya la valider — Freya vérifie immédiatement la connexion et les permissions.
- Corrigez toute erreur signalée — Freya vous dit exactement ce qui ne va pas si la validation échoue.
Ce qu'est une clé API — et quelles permissions Freya nécessite
Une clé API est une paire d'identifiants (une clé et un secret) qui permet à une application de dialoguer avec votre compte d'exchange de façon limitée. C'est vous qui décidez ce que cette clé est autorisée à faire. Pour Freya, n'activez que :
- La lecture — pour que Freya puisse voir vos soldes, positions et statuts d'ordres.
- Le trading Spot et/ou le trading Futures — pour que votre bot puisse passer les ordres dont il a besoin. Activez celui qui correspond aux bots que vous prévoyez de faire tourner.
Freya passe des ordres ; elle n'a jamais besoin de sortir de l'argent de votre compte. Laissez toujours la permission de retrait désactivée sur la clé que vous connectez. C'est une permission que vous contrôlez sur l'exchange — avec elle désactivée, ni Freya ni quiconque obtenant la clé ne peut retirer vos fonds. C'est l'habitude la plus importante lorsqu'on connecte n'importe quelle plateforme de bots.
Étape 1 : Créer une clé API sur votre exchange
Dans la section gestion des API de votre exchange, créez une nouvelle clé API :
- Binance — créez la clé dans API Management, activez la lecture et le trading Spot et/ou Futures, et laissez les retraits désactivés.
- OKX — créez la clé et définissez une phrase secrète (vous en aurez besoin dans Freya) ; activez la lecture et le trading, pas les retraits.
- Bybit — créez la clé avec les permissions de lecture et de trading pour les produits que vous utiliserez, et laissez les retraits désactivés.
Si votre exchange propose une liste blanche d'IP, c'est une bonne pratique de restreindre la clé aux adresses IP de Freya. Si vous le faites, veillez à autoriser les IP de Freya, sinon la connexion sera refusée (voir le tableau des erreurs plus bas).
Lorsque vous créez la clé, l'exchange affiche le secret une seule fois. Copiez-le immédiatement et conservez-le en lieu sûr. Si vous le perdez, vous ne pouvez pas le récupérer — vous devrez supprimer la clé et en créer une nouvelle.
Étape 2 : Ajouter la clé à Freya
Dans Freya, allez dans Paramètres → Clés API et sélectionnez Ajouter une clé API. Puis :
- Choisissez votre exchange (Binance, OKX ou Bybit).
- Collez la clé API et le secret. Pour OKX, saisissez aussi la phrase secrète que vous avez définie.
- Donnez un nom à la clé pour pouvoir la reconnaître plus tard.
Vous pouvez connecter plusieurs exchanges, et gérer ou supprimer vos clés depuis cette même page à tout moment.
Étape 3 : Freya valide votre clé
Dès que vous ajoutez la clé, Freya vérifie la connexion et les permissions — sans deviner. Si tout est correct, la clé est vérifiée et prête à l'emploi. Si quelque chose ne va pas, Freya affiche un message clair expliquant exactement quoi corriger.
Comprendre les erreurs de validation
Si la validation échoue, faites correspondre le message affiché par Freya à la solution ci-dessous :
| Ce que Freya affiche | Ce que cela signifie | Comment corriger |
|---|---|---|
| Clé API invalide | La clé a été copiée incorrectement ou supprimée sur l'exchange | Recopiez la clé API exactement, ou créez-en une nouvelle |
| Secret invalide | Le secret ne correspond pas à la clé | Recopiez le secret ; si vous l'avez perdu, créez une nouvelle clé |
| Adresse IP non autorisée | La clé est restreinte par IP et l'adresse de Freya n'est pas autorisée | Autorisez les IP de Freya sur la clé, ou retirez la restriction d'IP |
| Permissions manquantes | La clé n'a pas la permission de lecture ou de trading | Activez la lecture et le trading Spot/Futures sur la clé |
| Permission de lecture désactivée | Freya ne peut pas lire votre compte | Activez la permission de lecture/consultation sur la clé |
| Permission Spot/Futures désactivée | La clé ne peut pas passer les ordres dont votre bot a besoin | Activez le type de trading (Spot ou Futures) qui correspond à votre bot |
| Échec de connexion | Un problème temporaire de réseau ou d'exchange | Patientez un instant et réessayez d'ajouter la clé |
Freya signalera également une clé en mode « Non restreint » — c'est-à-dire sans restriction d'IP. Pour votre sécurité, Freya vous demande d'activer la restriction d'IP et d'ajouter l'adresse qu'elle affiche avant que la clé puisse être enregistrée. N'activez que la lecture et le trading (jamais le retrait), et restreignez la clé à l'IP de Freya. (Plus d'informations sur les erreurs de connexion dans Impossible de connecter votre exchange ?.)
Un mot sur la sécurité
La connexion est sûre par conception, mais quelques habitudes la maintiennent ainsi :
- Retrait désactivé, toujours — Freya n'en a jamais besoin.
- Utilisez la liste blanche d'IP lorsque votre exchange le permet.
- Une clé, un usage — et supprimez les clés que vous n'utilisez plus.
Pour une vue complète de la protection de vos fonds et de vos clés, consultez Mon argent est-il en sécurité sur Freya Finance ? et Sécurité des API d'exchange et atténuation des risques.
Questions fréquentes
De quelles permissions Freya a-t-elle besoin sur ma clé API ?
La lecture (pour voir vos soldes, positions et ordres) et le trading Spot et/ou Futures (pour passer les ordres de votre bot). Activez le type de trading qui correspond aux bots que vous ferez tourner. Freya n'a jamais besoin de la permission de retrait, alors laissez-la toujours désactivée.
Freya a-t-elle besoin de la permission de retirer mes fonds ?
Non. Freya ne fait que passer et gérer des ordres ; elle ne peut pas et ne doit pas pouvoir sortir des fonds de votre exchange. Laissez toujours la permission de retrait désactivée sur la clé que vous connectez — c'est une permission que vous contrôlez sur l'exchange.
Pourquoi Freya affiche-t-elle « Adresse IP non autorisée » ?
Votre clé API est restreinte à des adresses IP spécifiques, et l'adresse de Freya n'est pas sur la liste. Ajoutez soit les adresses IP de Freya à la liste blanche de la clé sur votre exchange, soit retirez la restriction d'IP de la clé. Après l'avoir mise à jour, ajoutez de nouveau la clé dans Freya.
Pourquoi affiche-t-elle « Clé API invalide » ou « Secret invalide » ?
Habituellement, la clé ou le secret a été copié incorrectement, ou la clé a été supprimée ou régénérée sur l'exchange. Recopiez exactement les deux valeurs. Comme le secret n'est affiché qu'une seule fois à la création de la clé, si vous ne l'avez plus, supprimez la clé sur l'exchange et créez-en une nouvelle.
Qu'est-ce que la phrase secrète, et pourquoi OKX la demande-t-elle ?
Les clés API OKX incluent une phrase secrète que vous définissez vous-même à la création de la clé — c'est un identifiant supplémentaire aux côtés de la clé et du secret. Saisissez la même phrase secrète dans Freya lors de l'ajout d'une clé OKX. Binance et Bybit n'utilisent pas de phrase secrète.
Puis-je connecter plusieurs exchanges ?
Oui. Vous pouvez ajouter des clés API pour Binance, OKX et Bybit, et les gérer ou les supprimer à tout moment depuis Paramètres → Clés API.
Est-il sûr de donner ma clé API à Freya ?
Oui, lorsque la clé est configurée correctement — lecture et trading uniquement, pas de retrait, et liste blanche d'IP là où c'est possible. Vos fonds restent sur votre propre exchange, et la clé que vous partagez ne peut pas les déplacer. Pour l'explication complète, consultez Mon argent est-il en sécurité sur Freya Finance ?.
Quels exchanges Freya prend-elle en charge ?
Freya se connecte actuellement à Binance, OKX et Bybit (spot et futures). D'autres exchanges pourront être ajoutés avec le temps. Vous tradez sur celui que vous connectez — vos fonds et les marchés disponibles restent sur cet exchange.
Quelles cryptos ou paires de trading puis-je trader ?
Les paires disponibles proviennent des propres cotations de votre exchange connecté, et non d'une liste Freya distincte — donc si votre exchange cote une paire (par ex. BTC/USDT, ETH/USDT), vous pouvez y construire un bot. La plupart du trading se fait contre l'USDT comme devise de cotation. Si un exchange retire une paire de la cote, elle cesse d'y être négociable.