Comment connecter OKX à ZeroLoss : configuration de la clé API
ZeroLoss trade les swaps perpétuels à marge USDT d’OKX sur votre propre compte OKX. La connexion passe par une clé API que vous créez sur OKX, et non par votre mot de passe, et cette clé n’a besoin que de l’autorisation de lire votre compte et de trader des futures. Votre argent reste sur OKX en permanence. Ce guide explique comment créer cette clé, la restreindre et la connecter à ZeroLoss. Comptez environ cinq minutes.
Vous voulez voir le bot trader avant de connecter quoi que ce soit ? Le test gratuit de 7 jours en paper trading ne nécessite aucune plateforme.
Avant de commencer
- Un compte OKX avec l’authentification à deux facteurs activée. Si vous êtes dans l’EEE, utilisez eea.okx.com, et aux États-Unis us.okx.com : les clés d’un site ne fonctionnent pas sur un autre. Dans certaines régions, OKX exige au moins 100 USD d’actifs avant de vous laisser créer une clé.
- Un mode de compte qui autorise les futures. Dans Trade settings → Account mode, choisissez n’importe quel mode autre que Spot mode ; le mode Spot bloque le trading de contrats. Ce réglage ne peut être modifié que sur le site web ou dans l’application.
- Au moins 100 USDT sur votre Trading account. Utilisez Assets → Transfer, du Funding account vers le Trading account.
- Un compte ZeroLoss. Vous pouvez commencer par le test gratuit en paper trading et connecter votre plateforme plus tard.
Étape 1 : créer la clé API sur OKX
- Sur le site d’OKX, ouvrez Profile → API and connections (dans l’application : Menu → API), puis Create API key (Créer une clé API).
- Nommez la clé, choisissez votre compte principal (ou le sous-compte qui détient les USDT) et l’usage correspondant à votre propre trading via API.
- Ajoutez la liste d’IP autorisées (étape 3) et les autorisations (étape 2).
- Définissez une passphrase. Choisissez-en une robuste, avec majuscules, minuscules, un chiffre et un symbole, et notez-la : OKX ne peut ni l’afficher ni la récupérer, et ZeroLoss en a besoin.
- Confirmez, puis copiez l’API key et la Secret key.
Étape 2 : choisir les permissions
- Read : activé.
- Trade : activé. Cette autorisation permet de passer et d’annuler des ordres.
- Withdraw : désactivé.
- Transfer, Loan et Earn : désactivés. ZeroLoss n’en a jamais besoin.
Étape 3 : limiter la clé aux adresses IP de ZeroLoss
Restreindre une clé à quelques adresses IP signifie qu’elle ne fonctionne que depuis ces serveurs, même si quelqu’un l’a copiée. Dans l’application ZeroLoss, ouvrez Connecter un exchange ; l’étape Ajouter nos IP liste les adresses des serveurs de ZeroLoss avec un bouton Tout copier. Collez-les dans le champ de restriction IP sur OKX.
OKX accepte jusqu'à 20 adresses par clé, séparées par des virgules ou des espaces. Une clé de trading sans liste d'IP autorisées est supprimée automatiquement après 14 jours sans utilisation ; les clés avec une liste d'IP autorisées n'expirent pas.
Étape 4 : connecter la clé dans ZeroLoss
- Connectez-vous à ZeroLoss et ouvrez Connecter un exchange.
- Sous 1 · Pick your exchange, choisissez OKX.
- Sous 2 · Paste your API key, collez votre clé API, votre clé secrète et votre passphrase. La passphrase est celle que vous avez saisie en créant la clé sur OKX ; OKX ne peut pas l'afficher à nouveau.
- Cliquez sur Verify & connect. ZeroLoss vérifie la clé et lit votre solde futures. La connexion nécessite au moins 100 USDT sur votre compte Trading OKX.
Vérifier que la clé est sûre
Ouvrez la page de gestion des API sur OKX et regardez la clé que vous avez créée. Elle doit autoriser la lecture et le trading de futures, avec les retraits désactivés. Pour arrêter ZeroLoss à tout moment, supprimez la clé sur OKX : le trading via cette clé s'arrête immédiatement, sans aucune intervention de notre part. Notre guide sur les clés API limitées au trading explique pourquoi c'est le réglage qui compte.
Problèmes fréquents
- Ordres refusés alors que la clé est correcte : le compte est en mode Spot. Changez le mode du compte dans les paramètres de trading d'OKX.
- Clé, secret et passphrase semblent corrects mais échouent : ils doivent tous provenir du même compte (compte principal ou sous-compte) et du bon site régional (okx.com, eea.okx.com ou us.okx.com).
- Passphrase perdue : OKX ne peut pas l'afficher. Supprimez la clé et créez-en une nouvelle.
- « Invalid API Key or Secret » : un caractère a été oublié lors de la copie. Copiez à nouveau les deux ; si la clé secrète n'a pas été enregistrée, supprimez la clé et créez-en une nouvelle.
- « API key missing required permissions » : le trading de futures ou la lecture n'est pas coché sur la clé. Modifiez la clé, ou créez-en une nouvelle avec les deux.
- « API IP restriction issue » : la clé est restreinte, mais pas à toutes les adresses de ZeroLoss. Utilisez Tout copier dans l'application et collez à nouveau la liste complète.
- « Minimum 100 USDT required in Futures wallet » : vos USDT sont sur le compte Funding. Transférez-les vers le compte Trading sur OKX et réessayez.
Le trading de futures crypto comporte un risque élevé de perte, et l'automatisation ne le supprime pas. Les écrans des plateformes changent de temps en temps ; si un menu semble différent, ce sont les noms de permissions ci-dessus qu'il faut chercher. Cette page fournit des informations générales et ne constitue pas un conseil financier. Consultez notre Avertissement sur les risques et la responsabilité.