Créer et lier une clé API OKX : permissions et mode couverture

Avant de commencer : créez un sous-compte

La plateforme ne gère que les positions qu’elle a ouvertes. Si le compte lié détient déjà des positions sur contrats, elle refuse de le reprendre pour ne jamais clôturer vos trades manuels par erreur. Nous recommandons vivement un sous-compte OKX dédié à la stratégie, alimenté séparément.

Pour un premier essai, vous pouvez aussi utiliser le trading démo d’OKX : créez une clé API démo distincte. Signaux et contrôles de risque sont identiques au réel, vous découvrez le fonctionnement avant de passer à une clé réelle.

Étape 1 : créer la clé API

Connectez-vous à OKX (basculez sur le sous-compte si besoin), ouvrez la gestion des API depuis le menu du profil, cliquez sur Créer une clé API, choisissez le trading par API comme usage et donnez-lui un nom reconnaissable.

Cochez uniquement Lecture et Trading. Ne cochez pas Retrait : sans ce droit, la plateforme ne peut pas déplacer vos fonds.

Définissez une passphrase et terminez la vérification de sécurité. La page affiche alors la clé API, la clé secrète et la passphrase. La clé secrète n’apparaît qu’une seule fois : enregistrez-la immédiatement en lieu sûr.

Étape 2 : passer en mode couverture

Le système gère séparément les positions longues et courtes et leurs stops. Dans les paramètres de trading OKX, réglez le mode de position sur long/short (couverture). Le changement peut être bloqué si vous avez des positions ou des ordres ouverts : soldez-les d’abord.

La plateforme ne modifie jamais vos paramètres. Si le mode est incorrect, la liaison échoue avec un message indiquant que le mode couverture est requis.

Étape 3 : lier la clé et ajuster la marge

Sur la page Compte, choisissez OKX et saisissez la clé API, la clé secrète et la passphrase. La plateforme les vérifie directement auprès d’OKX, puis les chiffre par utilisateur ; la page et l’API ne les renvoient plus jamais en clair.

Ouvrez ensuite la vérification des fonds sur la page Stratégie. Elle lit votre solde en temps réel, vérifie que l’utilisation de marge dans le pire cas ne dépasse pas les fonds disponibles et propose sinon des valeurs à appliquer en un clic. Vérifiez enfin que la stratégie est activée en mode exécution automatique.

Erreurs de liaison courantes

Mode couverture requis : revenez à l’étape 2, changez le mode de position et relancez la vérification.

Positions inconnues sur le compte : il existe des positions que la plateforme n’a pas ouvertes. Clôturez-les ou liez un sous-compte vierge.

Des signaux mais aucun ordre : le plus souvent fonds insuffisants, nombre maximal de positions atteint ou stratégie en mode observation. Appliquez les suggestions de la vérification des fonds.

La clé API OKX a-t-elle besoin du droit de retrait ?

Non, et elle ne doit pas l’avoir. Lecture et Trading suffisent ; sans droit de retrait, personne ne peut déplacer de fonds via la plateforme.

Et si je perds la clé secrète ou la passphrase ?

OKX ne réaffiche pas la clé secrète. Supprimez l’ancienne clé, créez-en une nouvelle et liez-la à nouveau sur la page Compte.

Comment révoquer l’accès plus tard ?

Déliez la clé sur la page Compte à tout moment, ou supprimez-la sur OKX : elle cesse immédiatement de fonctionner.