Questions fréquentes sur l'API OKX

À quoi fait référence la phrase secrète ?

C'est le mot de passe que tu as saisi lors de la demande de la Clé API. Tu dois le mémoriser toi-même. Une fois oublié, tu ne pourras pas le récupérer et tu devras créer une nouvelle Clé API.

Comment créer une clé API ?

Sur l'application :

1. Connecte-toi à ton Compte OKX > Sélectionne Menu (⋮⋮⋮) > Fais défiler vers le bas et sélectionne Clé API > Créer une clé API

2. Remplis le nom de l’API > Sélectionne le compte et le but > Entre la liste blanche d’adresses IP > Sélectionne les autorisations > Entre la phrase secrète

Sur le Web :

1. Connecte-toi à ton Compte OKX > Va dans ton Profil et sélectionne API et connexions > Créer une clé API

2. Remplis le nom de la Clé API > Sélectionne le compte et le usage

3. Saisis la liste blanche des adresses IP > Sélectionne Autorisations > Saisis la phrase secrète

Remarque :

• Les adresses IP contribuent à sécuriser ta clé API. Tu peux associer jusqu'à 20 adresses par clé, en les séparant par une virgule ou un espace.

• Tu dois consulter les informations de l’API et accéder à son interface. Merci de garder ton mot de passe en sécurité. Tu peux créer une nouvelle API si tu perds le mot de passe, car nous ne pouvons pas récupérer les API.

Comment gérer ou modifier la clé API ?

Pour gérer ou modifier ta clé API sur OKX :

1. Connecte-toi à ton Compte OKX et va dans Profil > API.

2. Tu verras une liste de tes clés API existantes. Clique sur celle que tu souhaites gérer.

3. À partir d'ici, tu peux :

   • Voir le nom de la clé API, les autorisations et la liste blanche d'IP associée.

   • Modifier le nom de la clé, les autorisations (Lecture, Trader, retirer), ou les adresses IP associées.

   • Supprime la clé si elle n'est plus nécessaire.

Remarque : Tu ne peux pas voir la phrase secrète après sa création initiale. En cas de perte, tu devras supprimer la clé existante et en créer une nouvelle. Stocke toujours tes identifiants en toute sécurité.

Comment différencier le trading au comptant du trading sur marge lorsque j'utilise l'API pour trader ?

La manière dont le trading au comptant et le trading sur marge sont différenciés via l'API peut varier en fonction de ton type de compte et de tes paramètres. Nous te recommandons de consulter la documentation API OKX pour obtenir les paramètres les plus précis et à jour applicables à la configuration de ton compte.

Si tu as besoin de plus de précisions, contacte l’Assistant OKX pour une assistance personnalisée.

Comment créer une clé API de disque de démonstration ?

Pour trader sur le demo disk API, tu dois créer une Clé API sur le demo disk. Suis les étapes ci-dessous :

Connecte-toi à ton Compte OKX > Trading > trading en mode démo > Centre personnel > Créer une Clé API de compte démo > Commencer le trading en mode démo

La clé API expirera-t-elle ?

Les clés API qui ne sont pas liées à une adresse IP et qui disposent des autorisations de transaction ou de retrait seront automatiquement supprimées après 14 jours d'inactivité. Les clés API ne seront pas considérées comme inactives si elles sont utilisées pour appeler des interfaces privées ou liées au compte nécessitant une vérification d’identité, telles que la consultation du solde du compte, des données de facturation ou la passation d’ordres.

Seules les clés API en lecture seule liées à une adresse IP ou à des autorisations spécifiques n'expireront pas.

Quelles sont les autorisations Loan, Earn et transférer ?

• Transférer : Permet à la clé de transférer des fonds entre tes comptes. Disponible pour tous les comptes.

• Loan : Permet à la clé d'emprunter, de rembourser et de gérer les Loan. Visible uniquement si ton compte dispose de l'éligibilité requise pour cette fonctionnalité.

• Earn : Permet à la clé de s'abonner et de récupérer les produits Earn. Visible uniquement si ton compte dispose de l'éligibilité requise pour cette fonctionnalité.

Si ta clé API avait auparavant les autorisations de Trader activées, les trois autorisations seront automatiquement activées lors de cette mise à jour. Aucune configuration manuelle n'est requise.

Peut-on passer des ordres en unités de devise lors de la passation d'ordres via l'interface ?

Non ; pour les ordres sur contrats, l'interface affiche par défaut les ordres en nombre de contrats. Si tu as besoin de calculer la conversion entre le nombre de contrats et les jetons, tu peux te référer à l'interface de conversion nombre de contrats-vers-jeton ici.

Comment obtenir le taux de fluctuation de l'interface ?

L'interface ne peut pas obtenir directement la hausse ou la baisse du cours, mais cela peut être calculé à l'aide d'une formule de calcul.

La variation en valeur du dernier cours de transaction par rapport au cours d'ouverture du chandelier il y a 24 heures / 100 % du cours d'ouverture du chandelier il y a 24 heures.

Les données de la formule ci-dessus peuvent être obtenues via l'interface du marché ici.

Quelle est la raison du message d'erreur « 51000 Parameter posSide error » lors de la passation d'un ordre ?

Tu dois d'abord vérifier le mode du compte ; mode achat et vente/mode ouverture et fermeture, que tu peux consulter ici pour obtenir posMode.

Remarque :

• Dans le cas de l'ouverture et de la fermeture de positions ainsi que de la passation d'ordres utilisant un contrat, le paramètre posSide est obligatoire, et longue ou courte doit être renseigné.

• S'il s'agit d'un mode d'achat et de vente, ou d'une transaction en cryptomonnaie ou à effet de levier effectuée en mode ouverture et fermeture, posSide ne prend en charge que la transmission nette ou aucune transmission.

Quelle interface peut être utilisée pour obtenir la valeur nominale du contrat et la quantité minimale de l'ordre ?

Tu peux utiliser l'interface pour obtenir des informations de base sur les produits de trading ici.

valeur nominale du contrat : ctVal, quantité minimale de l'ordre : minSz.

Quel est le format de instId ?

Tu peux utiliser directement l'interface pour obtenir les informations de base des produits de trading ici.

Comment définir un stop Loss et un Take Profit ?

Si l'ordre est lié à un take profit ou un stop Loss, tu peux te référer à l'interface des ordres ici : paramètres du tableau attachAlgoOrds.

Cependant, s'il s'agit d'un stop Loss d'ordre séparé, tu peux te référer à l'interface de commission de stratégie ici.

Pourquoi une erreur est-elle signalée lors de la définition du cours de déclenchement pour le Take Profit et le stop Loss : 51046, 51047, 51048, 51049 ?

Règles pour définir le cours de déclenchement du stop-loss / le cours de déclenchement du take-profit – lors de la vente, le cours de déclenchement du take-profit est supérieur au dernier prix de transaction, et le cours de déclenchement du stop-loss est inférieur au dernier prix de transaction ; lors de l'achat, le cours de déclenchement du take-profit est inférieur au dernier prix de transaction, et le cours de déclenchement du stop-loss est supérieur au dernier prix de transaction.

Qu'est-ce que « Erreur d'interface : 50102 Requête de timestamp expirée » ?

Cette erreur se produit lorsque le timestamp a expiré. Tu dois appeler l'interface de l'heure système ici pour synchroniser ton heure locale avec celle de notre serveur. Maintenir un écart de temps inférieur à 30 secondes peut aider à éviter ce problème.

Remarque : l'heure dans l'en-tête de la requête est en UTC0. Lors de l'appel à l'interface de l'heure du serveur, l'heure est fournie en UTC + 8.

Qu'est-ce que « Erreur d'interface : 50101 APIKey ne correspond pas à l'environnement actuel » ?

Cela est dû à une incompatibilité entre la clé API et l'environnement actuel. Les appels de compte réel nécessitent l'utilisation de la clé API du compte réel, et la valeur du paramètre x-simulated-trading dans l'en-tête de la requête doit être 0. Les appels de compte simulé nécessitent l'utilisation de la clé API du compte simulé, et la valeur du paramètre x-simulated-trading dans l'en-tête de la requête doit être 1.

Qu'est-ce que « Erreur d'interface : 51010 Requête non prise en charge dans le mode du compte actuel » ?

Cela concerne ton mode du compte. Si tu souhaites placer un effet de levier ou un contrat sur une seule devise, tu dois passer à l'un des trois autres modes, à l'exception du mode de trading au comptant ! Tu peux le configurer via les paramètres de l'interface ici, ou bien le régler sur le site web ou l'application.

Remarque : le premier paramètre doit être configuré sur la page ou l'application ; option des paramètres dans le menu principal de la page de trading - mode du compte.

Qu'est-ce que « Erreur d'interface : 51121 La quantité de l'ordre doit être un multiple de la taille du lot » ?

Dans l'API, les ordres de contrat sont exprimés en unités de contrats et doivent être un multiple de la quantité minimale d'ordre de la paire de devises. La quantité minimale d'ordre peut être obtenue via le champ minSz de l'interface produit ici.

"Erreur de retrait : 58207 L'adresse de retrait n'est pas sur la liste blanche pour l'exemption de vérification" ; pourquoi la vérification de la liste blanche signale-t-elle toujours une erreur alors qu'elle est désactivée sur la page de retrait ?

Pour retirer des pièces via l'interface API, il est nécessaire d'ajouter une adresse de retrait sur la page et de cocher le bouton non vérifié par visa. Que la vérification de la liste blanche soit désactivée sur la page n'affectera pas la fonction de l'interface.

Que signifie « Erreur d'interface : délai d'attente de la requête du point de terminaison API 50004 » (cela ne signifie pas que la requête a réussi ou échoué, veuillez vérifier le résultat de la requête) ?

Le code 50004 est généralement causé par une pression excessive sur le serveur. Les heures de 8 h, 16 h et 24 h sont les moments de collecte des frais de capital chaque jour. À ces moments, la pression sur le serveur est élevée. Il est recommandé d'échelonner les transactions à ces heures. Si une erreur 50004 est signalée à d'autres moments, elle peut être réessayée plus tard. Si un ordre est passé avec une erreur 50004, cela ne reflète pas le résultat réel de la requête d'interface. La requête peut réussir ou échouer. Veuillez vous référer au résultat réel.

Qu'est-ce que l'erreur "50119 API key n'existe pas" ?

Cette erreur se produit généralement lorsque le domaine de ton compte ne correspond pas à ta région.

• Pour les utilisateurs de l'EEE, veuillez changer le nom de domaine de votre requête API en eea.okx.com au lieu de www.okx.com.

• Pour les utilisateurs américains, veuillez changer le nom de domaine de votre requête API en us.okx.com au lieu de www.okx.com.

• Si tu utilises un logiciel tiers pour te connecter à OKX et que tu vois cette erreur, vérifie auprès du fournisseur du logiciel s'il prend en charge les domaines régionaux. Par exemple, les utilisateurs de l'EEE doivent se connecter via eea.okx.com, sinon la requête échouera.

Pourquoi l'erreur « 50110 » s'affiche-t-elle lors de la liaison avec un logiciel tiers ?

Cette erreur peut survenir si le type actuel de Clé API n'est pas compatible avec la liaison du logiciel tiers. Essaie de demander une Clé API de type transaction, sans lier de liste d'IP, puis reconnecte le logiciel tiers.

Comment puis-je obtenir le dernier cours d'une certaine paire de devises ?

Utilise les détails ici pour les tickers et pour un ticker, ici. L'interface des tickers est utilisée pour obtenir en lot le dernier cours des paires de devises, et le ticker est utilisé pour obtenir le dernier cours d'une paire de devises individuelle.

Exemple du paramètre de réponse du dernier cours tradé dans la section Tickers

Quelles sont les conditions pour créer une Clé API ?

Un solde minimum d'Actifs Sous Gestion (AUM) de 100 USD est requis pour créer une Clé API.

• Un AUM supérieur à 100 USD (AUM > 100U) est requis pour créer une Clé API

• Pour les comptes principaux ou les sous-comptes, seuls les comptes avec un AUM > 100U sont autorisés à créer des clés API

Remarque : Cette exigence s'applique uniquement aux utilisateurs de certaines zones

Remarque :

Si tu as des questions sur WebSocket ou d'autres sujets liés à l'API, clique sur le lien de l'article et scanne le code QR en bas de l'article avec l'Appli OKX pour rejoindre le groupe et contacter notre spécialiste du support API.

Comment scanner : dans l'application, appuie sur Menu > l'icône Scanner, puis scanne le code QR.