Comment créer une clé API sur OKX pour les robots de trading ?

Accéder à l'interface de gestion des API

1. Connectez-vous à votre compte OKX à l'aide d'informations d'identification vérifiées et d'une authentification à deux facteurs.

2. Accédez à la section « Compte » dans le menu déroulant en haut à droite.

3. Sélectionnez « Gestion des API » dans le panneau de navigation de la barre latérale.

4. Cliquez sur le bouton « Créer une API » situé bien en vue sur le tableau de bord.

5. Confirmez votre identité par e-mail ou SMS si la couche de sécurité vous y invite.

Configuration des autorisations et des restrictions de l'API

1. Choisissez « Commerce » comme étendue d'autorisation principale pour les opérations de robot impliquant le placement et la gestion des commandes.

2. Activez l'accès « Lecture » ​​pour permettre la récupération des données de solde, de position et de marché sans droits d'exécution.

3. Spécifiez une liste blanche d'adresses IP en saisissant des adresses IPv4 ou des plages CIDR séparées par des virgules pour restreindre les origines des appels d'API.

4. Définissez une phrase secrète personnalisée, distincte de votre mot de passe de connexion, qui sera requise pour chaque demande signée.

5. Désactivez les autorisations « Retrait » et « Financement », sauf si cela est explicitement nécessaire pour une logique de marge croisée ou de transfert d'actifs.

Générer et sécuriser la paire de clés

1. Après avoir soumis la configuration, OKX génère instantanément une clé API de style UUID à 36 caractères.

2. Une clé secrète hexadécimale de 32 octets s'affiche une seule fois et ne peut pas être récupérée ultérieurement : copiez-la immédiatement.

3. Le système attribue une phrase secrète unique qui doit être stockée avec les deux autres informations d'identification.

4. Les trois valeurs (API Key , Secret Key et Passphrase ) sont requises pour chaque demande authentifiée.

5. Ne validez jamais ces valeurs directement dans le code source ; utilisez plutôt des variables d’environnement ou des coffres-forts chiffrés.

Tester la connexion API localement

1. Initialisez une instance TradeAPI à l'aide de python-okx avec les informations d'identification nouvellement créées et flag=0 pour le mode production.

2. Exécutez une requête de solde minimal : fundingAPI.get_balances(ccy='USDT') pour vérifier la validité de la signature et l'accessibilité du point de terminaison.

3. Surveillez les codes d'état HTTP : 200 réponses confirment la réussite de l'authentification et du routage.

4. Observez les en-têtes de limite de débit (OK-RLIMIT-LIMIT, OK-RLIMIT-REMAINING) pour calibrer la fréquence des requêtes du bot.

5. Déclenchez un ordre limité à sec avec tdMode='cash' et sz='0.0001' pour valider la logique de validation de l'ordre sans exécution réelle.

Intégration à l'infrastructure de trading basée sur Python

1. Chargez les informations d'identification via dotenv à partir d'un fichier .env contenant les entrées OKX_API_KEY, OKX_SECRET_KEY et OKX_PASSPHRASE.

2. Instanciez Trade.TradeAPI avec des paramètres incluant false pour le mode démo et la valeur d'indicateur appropriée en fonction de la cible de déploiement.

3. Utilisez MarketData.MarketAPI pour récupérer les tickers en temps réel avant la soumission de la commande afin d'éviter les hypothèses de prix obsolètes.

4. Enveloppez toutes les commandes dans des blocs try-sauf capturant okx.exceptions.OkxAPIException pour une gestion granulaire des erreurs.

5. Enregistrez les charges utiles de requête/réponse horodatées dans un tampon de fichier rotatif pour l'audit post-exécution et le profilage de latence.

Foire aux questions

Q : Puis-je réutiliser la même clé API sur plusieurs robots ? R : Oui, mais chaque robot doit fonctionner sous sa propre clé dédiée, avec une liste blanche d'adresses IP et des étendues d'autorisation personnalisées pour isoler l'impact des pannes.

Q : Que se passe-t-il si ma clé secrète est exposée ? R : Révoquez immédiatement la clé compromise via l'interface de gestion des API et générez-en une nouvelle. Aucune intervention manuelle du support OKX n'est requise.

Q : OKX impose-t-il une rotation obligatoire des phrases secrètes ? R : Non, mais la modification de la phrase secrète invalide toutes les signatures existantes et nécessite une réinitialisation complète des informations d'identification dans tous les services intégrés.

Q : La connexion WebSocket est-elle possible avec la même clé API ? R : Oui : les mêmes informations d'identification authentifient les connexions REST et WebSocket, bien que les abonnements WebSocket nécessitent un enregistrement de rubrique distinct.