Comment activer les graphiques TradingView sur OKX

Présentation de l'architecture d'intégration

1. OKX n'héberge pas nativement les graphiques TradingView dans son interface Web officielle. Au lieu de cela, les utilisateurs accèdent à TradingView via une intégration externe ou des intégrations tierces.

2. La plate-forme OKX fournit des données de marché en temps réel via les API REST et WebSocket, qui peuvent être consommées par une implémentation personnalisée de TradingView Datafeed.

3. Les développeurs doivent déployer la bibliothèque de graphiques TradingView sur leur propre domaine ou sous-domaine, puis configurer une couche de flux de données conforme à l'UDF pour relier les points de terminaison publics d'OKX.

4. Le mappage des symboles nécessite une normalisation : OKX utilise un format tel que BTC-USDT-SWAP , tandis que TradingView attend des identifiants tels que OKX:BTCUSDT.P pour les perpétuelles ou OKX:BTCUSDT.SPOT pour les paires spot.

5. La gestion du fuseau horaire doit s'aligner sur l'heure du serveur OKX (UTC+0) et les horodatages des bougies renvoyés par /api/v5/market/candles doivent être convertis en millisecondes depuis l'époque Unix sans dérive de décalage horaire.

Exigences de mise en œuvre du flux de données

1. Le point de terminaison /config doit renvoyer les intervalles pris en charge, les échanges pris en charge et les types de symboles par défaut, tous alignés sur les instruments disponibles d'OKX.

2. Le point de terminaison /symbols effectue une recherche floue sur la réponse /api/v5/public/instruments d'OKX, en filtrant pour status=live et instType=SWAP/SPOT/MARGIN.

3. Le point de terminaison /history mappe la demande de barre de TradingView (symbole, résolution, de, à) à /api/v5/market/candles d'OKX, en appliquant la limite correcte (max 100 barres par appel) et la traduction d'intervalle (par exemple, « 15 » → « 15m », « D » → « 1D »).

4. L'abonnement en temps réel repose sur le canal WebSocket d'OKX publicChannel:candle15m (ou équivalent), où chaque message est analysé, normalisé et transmis au onRealtimeCallback de TradingView.

5. Les champs de volume dans les réponses OKX utilisent volCcy (volume de la devise de cotation) et vol (volume de la devise de base) ; TradingView s'attend à un volume en unités de base, le volume est donc sélectionné pour des raisons de cohérence.

Résolution des symboles et mappage des instruments

1. Les paires de trading au comptant nécessitent le suffixe .SPOT : BTC-USDT devient OKX:BTCUSDT.SPOT .

2. Les swaps perpétuels avec marge USDT utilisent .P : BTC-USDT-SWAP correspond à OKX:BTCUSDT.P .

3. Les contrats avec marge de pièces ajoutent .C : BTC-USD-SWAP devient OKX:BTCUSD.C .

4. Chaque symbole résolu doit inclure les heures de session spécifiques à l'échange, la taille minimale du tick, l'échelle de prix et les chiffres fractionnaires dérivés des champs tickSz et lotSz d'OKX.

5. Le niveau de marge, le taux de financement et les intérêts ouverts sont exclus du rendu graphique standard de TradingView, mais peuvent être injectés dans les superpositions de widgets via une logique JS personnalisée après l'initialisation.

Considérations sur l’authentification et la limitation du débit

1. Les points de terminaison de données publiques ( /market/candles , /public/instruments ) ne nécessitent pas de clés API mais appliquent des limites de débit strictes : 20 requêtes par seconde et par IP.

2. Les connexions WebSocket doivent se reconnecter lors de la déconnexion et se réabonner aux canaux requis à l'aide du mécanisme de validation du numéro de séquence et de battement de cœur documenté d'OKX.

3. La mise en cache côté client des barres historiques est obligatoire pour éviter les appels HTTP redondants lors d'un zoom ou d'un panoramique sur des plages de temps déjà récupérées.

4. Les getBars de TradingView peuvent demander des fenêtres horaires qui se chevauchent ; une logique de déduplication doit être implémentée dans le flux de données pour empêcher l'insertion de barres en double.

5. Toutes les réponses d'erreur d'OKX — y compris 500001 (erreur interne), 51000 (limite de taux dépassée) et 58005 (instrument introuvable) — doivent être traduites en codes d'erreur TradingView standardisés et enregistrées sans exposer les messages d'erreur OKX bruts aux utilisateurs finaux.

Foire aux questions

Q1 : Puis-je intégrer TradingView directement dans l'interface de trading officielle d'OKX ? NON. OKX n'autorise pas l'injection de scripts tiers dans son interface utilisateur de production. Toute intégration TradingView doit avoir lieu en dehors du domaine OKX, soit via un tableau de bord autonome, soit via une extension de navigateur qui superpose les graphiques sur les pages OKX.

Q2 : OKX fournit-il la prise en charge WebSocket pour les barres en temps réel dans TradingView ? OUI. OKX prend en charge le streaming en chandeliers sur WebSocket en utilisant des canaux tels que publicChannel:candle15m . Cela permet des mises à jour des barres en direct sans interrogation, à condition que le flux de données gère correctement le séquençage des messages et la détection des écarts.

Q3 : Pourquoi certains symboles apparaissent-ils comme « Aucune donnée » même après un mappage correct ? Cela se produit lorsque l' état instState de l'instrument n'est pas « actif » ou lorsque la résolution demandée n'est pas prise en charge pour ce type d'instrument. Par exemple, OKX ne publie pas de bougies d'une seconde pour les échanges perpétuels.

Q4 : Est-il possible d'afficher la profondeur du carnet de commandes OKX à côté des graphiques TradingView ? OUI. Les données de profondeur de /api/v5/market/books peuvent être restituées séparément à l'aide de D3.js ou de bibliothèques de canevas légères, puis synchronisées avec les délais des graphiques via l'alignement de l'horodatage partagé et le positionnement DOM par rapport à l'élément conteneur TradingView.