Tous les produits mentionnés ne sont pas disponibles dans toutes les juridictions.

FAQ sur l’API OKX

Date de publication : 20 sept. 2024Date de mise à jour : 1 nov. 2024Lecture de 8 min4

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

Il s’agit du mot de passe que vous avez renseigné lors de la demande de clé API. Vous devez vous en souvenir vous-même. Si vous l’oubliez, vous ne pourrez plus le récupérer et vous devrez créer une nouvelle clé API.

Comment créer une clé API de disque en mode démo ?

Pour trader sur l’API de disque en mode démo, vous devez créer une clé API sur le disque démo. Suivez les étapes ci-dessous :

Connectez-vous à votre compte OKX > Trading > Trading en mode démo > Centre personnel > Créer une clé API de compte en mode 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 ont 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 à un compte nécessitant une vérification d’identité, telles que la visualisation 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.

Les ordres peuvent-ils être passés en USDT ou en unités de devise lors de la passation d’ordres via l’interface ?

Non, pour les ordres de contrats, l’interface est définie par défaut sur les ordres en nombre de contrats. Si vous devez calculer la conversion entre le nombre de contrats et de jetons, vous pouvez vous référer à l’interface de conversion nombre de contrats/jetons ici.

Comment obtenir le taux de fluctuation de l’interface ?

L’interface ne peut pas obtenir directement l’augmentation ou la diminution du cours, mais une formule en permet le calcul.

La valeur haussière et baissière du dernier cours de transaction par rapport au cours d’ouverture K-line il y a 24 heures/100 % du cours d’ouverture K-line il y a 24 heures.

Les données de la formule ci-dessus peuvent être obtenues via l’interface du marché ici (dernière ouverture 24 h)/ouverture 24 h.

Pour quelle raison le message d’erreur « 51000 Parameter posSide error » s’affiche lors de la passation d’un ordre ?

Vous devez d’abord vérifier le mode du compte pour obtenir posMode : mode d’achat et de vente/mode d’ouverture et de fermeture, qui peut être consulté ici.

Remarque :

  • Dans le cas d’ouverture et de fermeture de positions et de passation d’ordres à l’aide d’un contrat, le paramètre posSide est requis et le paramètre long ou court est rempli.

  • Si c’est un mode d’achat et de vente, ou si une transaction de cryptomonnaie ou à effet de levier est effectuée en mode d’ouverture et de fermeture, posSide ne prend en charge que la transmission nette ou nulle.

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

Vous pouvez utiliser l’interface pour obtenir des informations de base sur les produits de trading ici.

valeur nominale du contrat : ctVal, quantité d’ordre minimale : minSz.

Quel est le format d’instId ?

Vous pouvez utiliser l’interface directement pour obtenir des informations de base sur les produits de trading ici.

Exemple de format instId :

Effet de levier de jeton/jeton : BTC-USDT

Contrat perpétuel : norme de jeton : BTC-USD-SWAP, norme U : BTC-USDT-SWAP Toutes les lettres doivent être capitalisées

Contrat de règlement : norme de devise : BTC-USD-210326, norme U : BTC-USDT-210326 derniers deux chiffres de l’année + semaine actuelle ou semaine prochaine ou mois actuel ou mois prochain ou trimestre actuel ou trimestre prochain

Contrats d’options : options à la hausse BTC-USD-210326-2000-C, options de vente BTC-USD-210326-2000-P

Comment définir le Stop-loss et le Take-profit ?

Si l’ordre est joint à un Take-profit/Stop-loss, vous pouvez vous référer à l’interface des ordres ici : paramètres du tableau attachAlgoOrds.

Toutefois, s’il s’agit d’un ordre stop loss distinct, vous pouvez vous référer à l’interface de commission de la stratégie ici.

Pourquoi une erreur est-elle signalée au moment de configurer le cours de déclenchement du Take-profit/Stop-loss : 51046,47, 51048,49 ?

Règles pour définir le cours de déclenchement du Stop-loss/Take-profit : durant la vente, le cours de déclenchement Take-profit est supérieur au dernier cours de transaction et le cours de déclenchement Stop-loss est inférieur au dernier cours de transaction ; tandis qu’en cas d achat, le cours de déclenchement Take-profit est inférieur au dernier cours de transaction et le cours de déclenchement Stop-loss est supérieur au dernier cours de transaction.

À quoi correspond l’erreur « Interface error: 50102 Timestamp request expired » ?

Cette erreur se produit lorsque l’horodatage a expiré. Vous devez appeler l’interface horaire du système ici pour synchroniser votre heure locale avec celle de notre serveur. Limiter l’écart d’heure à 30 secondes peut aider à éviter ce problème.

Remarque : L’heure indiquée dans l’en-tête de la demande est UTC0. Lorsque vous appelez l’interface horaire du serveur, l’heure est indiquée en UTC + 8.

À quoi correspond l’erreur « Interface error: 50101 APIKey does not match the current environment » ?

Elle est due à une incohérence entre la clé API et l’environnement actuel. Les appels de comptes réels nécessitent l’utilisation de la clé API de compte réel, et la valeur du paramètre « x-simulated-trading » dans l’en-tête de la demande doit être de 0. Les appels de comptes simulés nécessitent l’utilisation de la clé API de compte simulé, et la valeur du paramètre « x-simulated-trading » dans l’en-tête de la demande doit être de 1.

À quoi correspond l’erreur « Interface error: 51010 Request unsupported under current account mode » ?

Cela est lié à votre mode de compte. Si vous souhaitez passer un effet de levier ou un contrat sur devise unique, vous devez adapter les trois autres modes, sauf le mode de trading au comptant ! Vous pouvez le configurer via les paramètres d’interface ici, ou le configurer sur le Web ou sur l’appli.

Remarque : Le premier paramètre doit être défini sur la page ou l’appli ; option des paramètres sur le menu principal de la page de trading - Mode de compte.

À quoi correspond l’erreur « Interface error: 51121 Order quantity must be a multiple of the lot size » ?

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

Erreur « Withdrawal error: 58207 Withdrawal address is not whitelisted for verification exemption » : pourquoi la vérification de la liste autorisée signale-t-elle toujours une erreur lorsqu’elle est fermée sur la page de retrait ?

Pour retirer des jetons à l’aide de l’interface API, il est nécessaire d’ajouter une adresse de retrait sur la page et de vérifier l’adresse non vérifiée par le bouton Visa. La désactivation de la vérification de la liste autorisée sur la page n’affectera pas la fonction d’interface.

À quoi correspond l’erreur « Interface error: 50004 API endpoint request timeout » (ne signifie pas que la requête a réussi ou échoué, vérifiez le résultat de la requête) ?

L’erreur 50004 est généralement causée par une pression excessive sur le serveur. Les frais de capital sont recueillis chaque jour à 8 h, 16 h et 0 h. À ces horaires, le serveur est fortement sous pression. Il est recommandé de stagger les transactions à ce moment-là. Si une erreur 50004 est signalée à un autre moment, vous pouvez réessayer ultérieurement. Si un ordre est passé avec une erreur 50004, il ne représente pas le résultat réel de la demande d’interface. La demande peut avoir été acceptée ou avoir échoué. Consultez le résultat réel.

Remarque : Si vous avez d’autres questions, notamment concernant l’API, vous pouvez nous contacter en scannant le code ci-dessous via l’appli.

okxapi-app-1

Avis de non-responsabilité
Ce contenu est uniquement fourni à titre d'information et peut couvrir des produits qui ne sont pas disponibles dans votre région. Il n’est pas destiné à fournir (i) un conseil en investissement ou une recommandation d’investissement ; (ii) une offre ou une sollicitation d’achat, de vente ou de détention d’actifs numériques ; ou (iii) un conseil financier, comptable, juridique ou fiscal. Les actifs numériques détenus, notamment les stablecoins et les NFT, présentent un degré de risque élevé et peuvent fluctuer considérablement. Évaluez attentivement votre situation financière pour déterminer si vous êtes en mesure de détenir des actifs numériques ou de vous livrer à des activités de trading. Demandez conseil auprès de votre expert juridique, fiscal ou en investissement pour toute question portant sur votre situation personnelle. Les informations (y compris les données sur les marchés, les analyses de données et les informations statistiques, le cas échéant) exposées dans la présente publication sont données à titre d'information générale uniquement. Bien que toutes les précautions raisonnables aient été prises lors de la préparation des présents graphiques et données, nous n'assumons aucune responsabilité quant aux erreurs relatives à des faits ou à des omissions exprimées aux présentes. Le portefeuille Web3 OKX et le marché des NFT d’OKX sont soumis à des conditions de service distinctes sur www.okx.com.

© 2024 OKX. Le présent article peut être reproduit ou distribué intégralement, ou des extraits de 100 mots ou moins du présent article peuvent être utilisés, à condition que ledit usage ne soit pas commercial. Toute reproduction ou distribution de l'intégralité de l'article doit déclarer de façon bien visible : « Cet article est © 2024 OKX et utilisé avec autorisation. » Les extraits autorisés doivent mentionner le nom et l’auteur de l'article, par exemple « Nom de l'article, [nom de l'auteur, le cas échéant], © 2024 OKX ». Aucune œuvre dérivée ou autre utilisation de cet article n'est autorisée.

À quoi fait référence la phrase secrète?
Comment créer une clé API de disque en mode démo ?
La clé API expirera-t-elle ?
Les ordres peuvent-ils être passés en USDT ou en unités de devise lors de la passation d’ordres via l’interface ?
Comment obtenir le taux de fluctuation de l’interface ?
Pour quelle raison le message d’erreur « 51000 Parameter posSide error » s’affiche lors de la passation d’un ordre ?
Quelle interface peut être utilisée pour obtenir la valeur nominale du contrat et la quantité minimale de l’ordre ?
Quel est le format d’instId ?
Comment définir le Stop-loss et le Take-profit ?
Pourquoi une erreur est-elle signalée au moment de configurer le cours de déclenchement du Take-profit/Stop-loss : 51046,47, 51048,49 ?
À quoi correspond l’erreur « Interface error: 50102 Timestamp request expired » ?
À quoi correspond l’erreur « Interface error: 50101 APIKey does not match the current environment » ?
À quoi correspond l’erreur « Interface error: 51010 Request unsupported under current account mode » ?
À quoi correspond l’erreur « Interface error: 51121 Order quantity must be a multiple of the lot size » ?
Erreur « Withdrawal error: 58207 Withdrawal address is not whitelisted for verification exemption » : pourquoi la vérification de la liste autorisée signale-t-elle toujours une erreur lorsqu’elle est fermée sur la page de retrait ?
À quoi correspond l’erreur « Interface error: 50004 API endpoint request timeout » (ne signifie pas que la requête a réussi ou échoué, vérifiez le résultat de la requête) ?