OKX で TradingView チャートを有効にする方法

統合アーキテクチャの概要

1. OKX は、公式 Web インターフェイス内で TradingView チャートをネイティブにホストしません。代わりに、ユーザーは外部の埋め込みまたはサードパーティの統合を通じてTradingViewにアクセスします。

2. OKX プラットフォームは、REST および WebSocket API を介してリアルタイムの市場データを提供し、カスタムの TradingView Datafeed 実装で使用できます。

3. 開発者は、TradingView Charting Library を独自のドメインまたはサブドメインにデプロイし、UDF 準拠のデータフィード レイヤーを構成して OKX のパブリック エンドポイントをブリッジする必要があります。

4. シンボル マッピングには正規化が必要です。OKX はBTC-USDT-SWAPのような形式を使用しますが、TradingView では永久通貨の場合はOKX:BTCUSDT.P 、スポット ペアの場合はOKX:BTCUSDT.SPOTなどの識別子が必要です。

5. タイムゾーンの処理は OKX のサーバー時間 (UTC+0) と一致する必要があり、 /api/v5/market/candlesから返されるキャンドルのタイムスタンプは、タイムゾーン オフセットのドリフトなしで Unix エポック以降のミリ秒に変換する必要があります。

データフィードの実装要件

1. /configエンドポイントは、サポートされるインターバル、サポートされるエクスチェンジ、およびデフォルトのシンボル タイプを返す必要があります。これらはすべて、OKX の利用可能なインスツルメントに合わせて調整されます。

2. /symbolsエンドポイントは、OKX の/api/v5/public/instruments応答に対してあいまい検索を実行し、status=live および instType=SWAP/SPOT/MARGIN でフィルタリングします。

3. /historyエンドポイントは、TradingView のバーリクエスト (シンボル、解像度、from、to) を OKX の/api/v5/market/candlesにマッピングし、正しい制限 (コールごとに最大 100 バー) と間隔変換 (例: 「15」→「15m」、「D」→「1D」) を適用します。

4. リアルタイム サブスクリプションは、OKX の WebSocket チャネルpublicChannel:candle15m (または同等) に依存しており、各メッセージが解析、正規化されて、TradingView のonRealtimeCallbackにプッシュされます。

5. OKX 応答のボリュームフィールドは、 volCcy (相場通貨ボリューム) とvol (基本通貨ボリューム) を使用します。 TradingView は出来高を基本単位で想定しているため、一貫性を保つためにvolが選択されます。

シンボルの解像度と計測器のマッピング

1. スポット取引ペアにはサフィックス.SPOTが必要です。BTC -USDTはOKX:BTCUSDT.SPOTになります。

2. USDT マージン付き永久スワップでは.Pを使用します。BTC -USDT-SWAPはOKX:BTCUSDT.Pにマップされます。

3. コインマージン契約には.Cが追加されます: BTC-USD-SWAPはOKX:BTCUSD.Cになります。

4. 解決された各シンボルには、取引所固有のセッション時間、最小ティック サイズ、価格スケール、OKX のTickSzおよびLotSzフィールドから得られる小数点以下の桁が含まれている必要があります。

5. 証拠金レベル、資金調達率、建玉は標準のTradingViewチャートレンダリングから除外されますが、初期化後のカスタムJSロジックを介してウィジェットオーバーレイに挿入される場合があります。

認証とレート制限に関する考慮事項

1. パブリック データ エンドポイント ( /market/candles 、 /public/instruments ) には API キーは必要ありませんが、IP ごとに 1 秒あたり 20 リクエストという厳しいレート制限が適用されます。

2. WebSocket 接続は切断時に再接続し、OKX の文書化されたシーケンス番号検証とハートビート メカニズムを使用して必要なチャネルに再サブスクライブする必要があります。

3. すでにフェッチされている時間範囲にわたってズームまたはパンするときに、冗長な HTTP 呼び出しを避けるために、履歴バーのクライアント側のキャッシュが必須です。

4. TradingView のgetBars は重複する時間ウィンドウを要求する場合があります。重複したバーの挿入を防ぐために、データフィードに重複排除ロジックを実装する必要があります。

5. OKX からのすべてのエラー応答 ( 500001 (内部エラー)、 51000 (レート制限超過)、および58005 (商品が見つかりません) を含む) は、標準化された TradingView エラー コードに変換され、生の OKX エラー メッセージをエンド ユーザーに公開することなくログに記録される必要があります。

よくある質問

Q1: TradingView を OKX の公式取引インターフェイスに直接埋め込むことはできますか?いいえ。 OKX では、実稼働 UI へのサードパーティのスクリプトの挿入は許可されていません。 TradingViewの統合は、スタンドアロンのダッシュボードまたはOKXページにチャートをオーバーレイするブラウザ拡張機能を介して、OKXのドメインの外で行う必要があります。

Q2: OKX は、TradingView のリアルタイム バーに対する WebSocket サポートを提供しますか?はい。 OKX は、 publicChannel:candle15mのようなチャネルを使用して、WebSocket 経由のローソク足ストリーミングをサポートします。これにより、データフィードがメッセージの順序付けとギャップ検出を正しく処理する場合、ポーリングを行わずにライブ バーの更新が可能になります。

Q3: 正しくマッピングした後でも、一部のシンボルが「データなし」と表示されるのはなぜですか?これは、計測器のinstStateが「ライブ」でない場合、または要求された解像度がその計測器タイプでサポートされていない場合に発生します。たとえば、OKX は永久スワップの 1 秒ローソク足を公開していません。

Q4: TradingView チャートと一緒に OKX オーダーブックの深さを表示することはできますか?はい。 /api/v5/market/booksからの深度データは、D3.js または軽量キャンバス ライブラリを使用して個別にレンダリングでき、その後、共有タイムスタンプの配置と TradingView コンテナ要素に対する DOM の位置決めを介してチャートのタイムフレームと同期できます。