如何在OKX上找到BTC/USDT市場？

市場符號映射

1. OKX使用標準化的工具ID格式，與常見的交易對錶示法不同。符號BTC-USDT是所有 OKX API 端點和 UI 元素中使用的官方工具 ID。

2. OKX 後端系統無法辨識 BTC/USDT 或 BTCUSDT 等傳統符號。嘗試在 API 呼叫中使用它們將導致OkxParamsException ，錯誤代碼為 51000。

3. 所有現貨、保證金和永續工具均嚴格執行連字符格式。這包括 ETH-USDT、SOL-USDT 和 XRP-USDT——沒有斜線、沒有串聯、沒有底線。

4. 透過 python-okx 檢索市場資料時， MarketAPI.get_ticker()方法需要準確的工具 ID。在發送任何網路請求之前，格式錯誤的字串會立即觸發拒絕。

5. 前端使用者可透過OKX網頁端或行動端搜尋列輸入「BTC」找到BTC-USDT。自動建議清單僅顯示有效的儀器 ID，過濾掉不合規的變體。

API端點導航

1. 股票行情資料的 RESTful 端點為/api/v5/market/ticker?instId=BTC-USDT 。此路徑區分大小寫，並且不接受單獨的查詢參數，例如基本或引用。

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」的交易請求傳回 HTTP 400，並顯示訊息「工具 ID 無效」。

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. 使用本機工具 ID 透過 UI 儲存觸發器配置的價格警報。編輯 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：我可以使用BTCUSDT代替BTC-USDT嗎？答：不會。所有 OKX API 和前端元件都會拒絕 BTCUSDT。僅接受 BTC-USDT。

Q：連字符會影響 WebSocket 重連邏輯嗎？答：是的。 instId 不正確的訂閱有效負載會導致伺服器在不傳送關閉訊框的情況下中斷連線。重新連線嘗試必須在重新訂閱之前更正符號。

Q：為什麼CCXT內部可以轉換BTC/USDT，而python-okx卻不能？ A：CCXT被設計為多交換抽象層； python-okx 是特定於交易所的，並假設開發人員直接使用 OKX 的本機約定。

Q：BTC-USDT API呼叫是否區分大小寫？答：是的。 btc-usdt 或 Btc-Usdt 將傳回錯誤代碼 51000。必須使用大寫字母和連字符。