如何在OKX下市價單？

OKX 市價訂單基礎知識

1. 市價訂單立即以訂單簿中最佳可用的價格執行，速度優先於價格控制。

2. 與限價訂單不同，市價訂單不需要指定價格－只有工具 ID 和大小是強制性的。

3. 市價訂單可能會出現滑點，尤其是在流動性較低或波動較大的時期。

4. OKX 對每個交易對執行最小規模要求，該要求因資產而異，必須遵守以避免被拒絕。

5. 對於現貨市場訂單， tdMode參數必須明確設定為「現金」 ，以區別於保證金或衍生性商品模式。

執行所需參數

1. instId標識交易對，如'BTC-USDT' ，必須符合 OKX 官方幣種命名規範。

2. side定義方向： 'buy'或'sell' ，API 強制區分大小寫。

3. ordType必須設定為'market' ；任何偏差都會觸發OkxParamsException 。

4. sz表示基礎貨幣（例如 BTC）的數量，並且必須作為十進位字串（而不是浮點數）傳遞以保持精確度。

5. 必須從環境變數或安全性設定來源正確載入api_key 、 Secret_key和passphrase 。

簽名和認證流程

1. 每個私有 REST 請求都需要使用Secret_key和規範訊息字串進行帶有時間戳記的 HMAC-SHA256 簽章。

2. 訊息格式嚴格為方法+路徑+時間戳+主體，其中主體對於GET請求為空，但包含POST請求的JSON負載。

3. 標頭必須包含OK-ACCESS-KEY 、 OK-ACCESS-SIGN 、 OK-ACCESS-TIMESTAMP和OK-ACCESS-PASSPHRASE 。

4. 時間戳記必須採用 ISO 8601 UTC 格式，精確度為毫秒，例如'2026-09-08T14:21:33.123Z' 。

5. 無法同步NTP伺服器±30秒內的系統時間，導致50113認證錯誤。

使用 python-okx 的 Python 實現

1. 透過pip install python-okx安裝程式庫並驗證與 Python 3.7+ 的版本相容性。

2. 匯入TradeAPI並使用憑證和標誌初始化（0 表示生產，1 表示演示）。

3. 將place_order()與ordType='market'結合使用，並確保sz是Decimal('0.01') — 而非0.01 。

4. 處理OkxParamsException 、 OkxRequestException等異常，區分輸入錯誤和網路故障。

5. 透過檢查回應的ordId和state欄位來確認執行，其中「filled」表示完全執行。

常見問題解答

Q：我可以在未啟用 API 金鑰交易權限的情況下下市價訂單嗎？答：不需要。建立 API 金鑰時必須明確啟用交易權限；否則，請求傳回錯誤代碼50006 。

Q：為什麼即使資金顯示可用，我的市價訂單也會失敗並顯示「餘額不足」？答：OKX 在執行前會檢查availBal和frozenBal 。鎖定在掛單或保證金部位的資金不計入可用餘額。

Q：現貨市場和期貨市場的市價訂單有差嗎？答：是的。期貨市場訂單需要tdMode='isolated'或'cross' ，並且sz是指合約數量（而不是基礎資產），添加特定於層的驗證。

Q：如果我在請求標頭中省略密碼，會發生什麼事？答：API 拒絕請求，狀態為401 ，錯誤代碼為50112 ，表示密碼遺失或無效。