OKX で BTC/USDT マーケットを見つけるには?

市場シンボルのマッピング

1. OKX は、一般的な取引ペアの表記とは異なる標準化された商品 ID 形式を使用します。シンボルBTC-USDTは、すべての OKX API エンドポイントおよび UI 要素で使用される公式の機器 ID です。

2. BTC/USDT や BTCUSDT などの従来の表記法は、OKX のバックエンド システムでは認識されません。これらを API 呼び出しで使用しようとすると、エラー コード 51000 のOkxParamsExceptionが発生します。

3. ハイフン付き形式は、すべてのスポット、マージン、および永久証券に厳密に適用されます。これには、ETH-USDT、SOL-USDT、および XRP-USDT が含まれます。スラッシュ、連結、アンダースコアは含まれません。

4. python-okx 経由で市場データを取得する場合、 MarketAPI.get_ticker()メソッドには正確な商品 ID が必要です。不正な形式の文字列は、ネットワーク要求がディスパッチされる前に即座に拒否を引き起こします。

5. フロントエンド ユーザーは、OKX の Web またはモバイル インターフェイスの検索バーに「BTC」と入力して、BTC-USDT を見つけることができます。自動提案リストには有効な機器 ID のみが表示され、非準拠のバリアントは除外されます。

APIエンドポイントナビゲーション

1. ティッカー データの RESTful エンドポイントは/api/v5/market/ticker?instId=BTC-USDTです。このパスでは大文字と小文字が区別され、base や quote などのクエリ パラメーターを個別に受け入れることはできません。

2. K ラインの取得には/api/v5/market/candles?instId=BTC-USDT&bar=1H を使用します。 bar パラメータは、OKX の事前定義された間隔 (1m、3m、5m、15m、30m、1H、2H、4H、6H、12H、1D、1W、1M) のいずれかである必要があります。

3. 注文発注エンドポイントには、同一の instId 形式が必要です。 instId: 'BTC/USDT'の取引リクエストは、メッセージ「Instrument ID valid」を含む HTTP 400 を返します。

4. WebSocket サブスクリプション メッセージも同じルールに従います。チャネルティッカーはJSON ペイロード{'channel':'tickers','instId':'BTC-USDT'}を想定しています。逸脱すると、エラー通知なしでサイレント切断が発生します。

5. CCXT はこのマッピングを内部的に抽象化しますが、 exchange.marketsオブジェクトを通じて透過的に公開します。開発者は、exchange.markets['BTC/USDT'].idを検査して、解決された OKX ネイティブ シンボルを確認できます。

フロントエンドインターフェイスの動作

1. OKX のメイン取引ページでは、BTC-USDT がデフォルトでスポットタブに表示されます。マージンまたは先物に切り替えると、基礎となるシンボル構造を変更せずに、表示される商品セットが変更されます。

2. オーダーブック深度チャートは、正しい商品 ID がアクティブな場合にのみ表示されます。 URL に?instrument_id=BTC%2FUSDTが含まれている場合、チャートは空白のままで、API リクエストは起動されません。

3. モバイル アプリのナビゲーションは、永続的な機器 ID キャッシュに依存しています。アセット リストで BTC-USDT を過ぎてスクロールしてもシンボルは再ロードされません。手動で変更するまで、最後の有効な instId 状態が保持されます。

4. 「アカウント > 履歴」セクションの過去の取引ログは、BTC-USDT を使用したすべての取引のみを参照します。エクスポートされた CSV ファイルは、変換せずにこの形式を保持します。

5. UI ストアを通じて設定された価格アラートは、ネイティブの商品 ID を使用してトリガーされます。 BTC/USDT のアラートを編集すると、永続化の前に自動的に BTC-USDT に変換されます。

モジュール間のデータの一貫性

1. python-okx の MarketData.py、Trade.py、および Account.py モジュールは、統一されたシンボル レジストリを共有します。モジュールごとに個別の構成はありません。不一致があると内部検証チェックが中断される可能性があります。

2. Books5およびCandle1mチャネルの WebSocket ストリームは、すべてのペイロードに「instId」:「BTC-USDT」を含むメッセージを送信します。生の JSON を解析するクライアントが正しくルーティングするには、この文字列と正確に一致する必要があります。

3. 複数の金融商品に対するバッチクエリには、カンマ区切りの BTC-USDT、ETH-USDT、SOL-USDT が必要です。スペース、セミコロン、または括弧はリクエスト全体を無効にします。

4. 失敗した注文からのエラー応答には、元の要求で間違った形式が使用されていた場合でも、応答本文に'instId': 'BTC-USDT'が含まれます。システムはログを記録する前に正規化します。

5. OKX の公開ドキュメントの例では、一貫して BTC-USDT が使用されています。コミュニティ チュートリアルでの逸脱は、古いパターンのコピー＆ペーストによる伝播により、統合の失敗を引き起こすことがよくあります。

よくある質問

Q: BTC-USDT の代わりに BTCUSDT を使用できますか? A: いいえ。BTCUSDT はすべての OKX API およびフロントエンド コンポーネントによって拒否されます。 BTC-USDT のみが受け入れられます。

Q: ハイフンは WebSocket の再接続ロジックに影響しますか? A: はい。不正な instId を持つサブスクリプション ペイロードにより、サーバーはクローズ フレームを送信せずに接続をドロップします。再接続を試みる場合は、再サブスクライブする前にシンボルを修正する必要があります。

Q: CCXT は内部で BTC/USDT を変換するのに、python-okx は変換しないのはなぜですか? A: CCXT は、マルチエクスチェンジ抽象化レイヤーとして設計されています。 python-okx は取引所固有であり、開発者が OKX のネイティブ規約を直接操作することを前提としています。

Q: BTC-USDT は API 呼び出しで大文字と小文字を区別しますか? A: はい。 btc-usdt または Btc-Usdt はエラー コード 51000 を返します。大文字とハイフンの配置は必須です。