Comment trouver le marché BTC/USDT sur OKX ?

Cartographie des symboles du marché

1. OKX utilise un format d'identification d'instrument standardisé qui diffère de la notation courante des paires de trading. Le symbole BTC-USDT est l'ID d'instrument officiel utilisé sur tous les points de terminaison de l'API OKX et les éléments de l'interface utilisateur.

2. Les notations héritées telles que BTC/USDT ou BTCUSDT ne sont pas reconnues par les systèmes backend d'OKX. Toute tentative de les utiliser dans les appels d'API entraînera une OkxParamsException avec le code d'erreur 51000.

3. Le format avec trait d'union est strictement appliqué pour tous les instruments au comptant, sur marge et perpétuels. Cela inclut ETH-USDT, SOL-USDT et XRP-USDT – pas de barres obliques, pas de concaténation, pas de traits de soulignement.

4. Lors de la récupération des données de marché via python-okx, la méthode MarketAPI.get_ticker() nécessite l'ID exact de l'instrument. Une chaîne mal formée déclenche un rejet immédiat avant l’envoi de toute requête réseau.

5. Les utilisateurs frontend peuvent localiser BTC-USDT en tapant « BTC » dans la barre de recherche de l'interface Web ou mobile d'OKX. La liste de suggestions automatiques affiche uniquement les ID d'instrument valides, filtrant les variantes non conformes.

Navigation au point de terminaison de l'API

1. Le point de terminaison RESTful pour les données du ticker est /api/v5/market/ticker?instId=BTC-USDT . Ce chemin est sensible à la casse et n'accepte pas les paramètres de requête tels que base ou quote séparément.

2. La récupération de la ligne K utilise /api/v5/market/candles?instId=BTC-USDT&bar=1H . Le paramètre de barre doit être l'un des intervalles prédéfinis d'OKX : 1m, 3m, 5m, 15m, 30m, 1H, 2H, 4H, 6H, 12H, 1D, 1W, 1M.

3. Les points de terminaison de passation de commande nécessitent un formatage instId identique. Une demande d'échange avec instId : 'BTC/USDT' renvoie HTTP 400 avec le message « ID d'instrument invalide ».

4. Les messages d'abonnement WebSocket suivent la même règle. Les tickers de chaîne attendent une charge utile JSON {'channel':'tickers','instId':'BTC-USDT'} . Tout écart provoque une déconnexion silencieuse sans notification d'erreur.

5. CCXT résume ce mappage en interne mais l'expose de manière transparente via l'objet Exchange.markets . Les développeurs peuvent inspecter Exchange.markets['BTC/USDT'].id pour vérifier le symbole natif OKX résolu.

Comportement de l'interface frontale

1. Sur la page de trading principale d'OKX, BTC-USDT apparaît par défaut sous l'onglet Spot . Le passage à Margin ou Futures modifie l'ensemble d'instruments visible sans altérer la structure des symboles sous-jacents.

2. Le graphique de profondeur du carnet de commandes s'affiche uniquement lorsque l'ID d'instrument correct est actif. Si l'URL contient ?instrument_id=BTC%2FUSDT , le graphique reste vide et aucune requête API ne se déclenche.

3. La navigation dans les applications mobiles repose sur la mise en cache persistante des identifiants d'instrument. Faire défiler BTC-USDT dans la liste des actifs ne recharge pas le symbole – il préserve le dernier état instId valide jusqu'à ce qu'il soit modifié manuellement.

4. Les journaux de transactions historiques dans la section Compte > Historique font référence à toutes les transactions utilisant exclusivement BTC-USDT. Les fichiers CSV exportés conservent ce format sans conversion.

5. Alertes de prix configurées via les déclencheurs du magasin de l'interface utilisateur à l'aide de l'ID d'instrument natif. La modification d'une alerte pour BTC/USDT la convertit automatiquement en BTC-USDT avant la persistance.

Cohérence des données entre les modules

1. Les modules MarketData.py, Trade.py et Account.py dans python-okx partagent un registre de symboles unifié. Il n'y a pas de configuration distincte par module : une incohérence interromprait les contrôles de validation internes.

2. Les flux Websocket pour les canaux books5 et Candle1m émettent des messages contenant « instId » : « BTC-USDT » dans chaque charge utile. Les clients analysant le JSON brut doivent correspondre à cette chaîne exacte pour acheminer correctement.

3. Les requêtes par lots pour plusieurs instruments nécessitent BTC-USDT, ETH-USDT, SOL-USDT séparés par des virgules. Les espaces, points-virgules ou crochets invalident l’intégralité de la demande.

4. Les réponses d'erreur des commandes ayant échoué incluent « instId » : « BTC-USDT » dans le corps de la réponse, même lorsque la demande d'origine utilisait un format incorrect : le système normalise avant de se connecter.

5. Les exemples de documentation publique d'OKX utilisent systématiquement BTC-USDT. Les écarts dans les didacticiels de la communauté provoquent souvent des échecs d’intégration en raison de la propagation par copier-coller de modèles obsolètes.

Foire aux questions

Q : Puis-je utiliser BTCUSDT au lieu de BTC-USDT ? R : Non. BTCUSDT est rejeté par toutes les API et composants frontaux OKX. Seul BTC-USDT est accepté.

Q : Le trait d'union affecte-t-il la logique de reconnexion WebSocket ? R : Oui. Les charges utiles d'abonnement avec un instId incorrect entraînent l'abandon de la connexion par le serveur sans envoyer de trame de fermeture. Les tentatives de reconnexion doivent corriger le symbole avant de se réinscrire.

Q : Pourquoi CCXT convertit-il BTC/USDT en interne, mais pas python-okx ? R : CCXT est conçu comme une couche d'abstraction multi-échanges ; python-okx est spécifique à Exchange et suppose que les développeurs travaillent directement avec les conventions natives d'OKX.

Q : Le BTC-USDT est-il sensible à la casse dans les appels d'API ? R : Oui. btc-usdt ou Btc-Usdt renverra le code d'erreur 51000. Les lettres majuscules et le placement des traits d'union sont obligatoires.