OKX現貨交易API權限如何管理？

現貨交易API權限配置

1. 完成驗證後，存取 OKX 帳戶儀表板中的 API 管理部分。

2. 點選“建立API Key”，選擇現貨交易作業所需的特定權限。

3. 啟用「讀取」權限以檢索餘額資訊、訂單歷史和市場資料。

4. 啟動「交易」權限，可在所有支援的交易對上下達、取消和修改現貨訂單。

5. 除非明確需要，否則避免啟用「提款」 ，因為它會增加與現貨執行無關的安全風險。

IP白名單和身分驗證強化

1. 為用於現貨交易的每個 API 金鑰指派靜態 IPv4 或 IPv6 位址（或 CIDR 子網路）。

2. 在發起任何與交易相關的請求之前，請確認IP綁定已啟動；具有交易許可的未綁定密鑰在 14 天不活動後過期。

3. 對每個專用端點呼叫使用HMAC-SHA256 簽名，包含時間戳記、HTTP 方法、請求路徑和正文雜湊。

4. 將密碼短語與密鑰分開存儲，並確保它永遠不會記錄或暴露在堆疊追蹤中。

5. 每季輪換一次 API 金鑰，並透過 API 管理介面立即撤銷過時的金鑰。

現貨訂單執行限制

1. 在所有現貨訂單有效負載中指定tdMode = 'cash'，以防止意外啟動保證金或融資模式。

2. 在提交訂單之前根據 OKX 的工具元資料驗證價格和規模精度 - BTC-USDT 要求價格精度為 0.01，規模精度為 0.00000001。

3. 明確設定ordType = 'limit'或'market' ；省略此欄位會觸發跨環境不一致的預設行為。

4. 包含用於客戶端訂單追蹤的clOrdId ，並避免跨會話重複使用識別碼。

5. 監控回應代碼，例如50113 （簽名不符）和58007 （價格偏差超出拍賣範圍），這兩種代碼在配置錯誤的現貨提交中很常見。

使用 OKX 示範環境測試工作流程

1. 在 testnet 網域下註冊一個單獨的 API 金鑰，flag=1，以將模擬流量與即時餘額隔離。

2. 使用 OKX 水龍頭為模擬帳戶提供資金，無需 KYC 要求 - 每次分配將在 72 小時後到期。

3. 在測試網和生產網路上執行相同的現貨訂單邏輯，比較延遲、拒絕率和填充確認時間。

4. 驗證GET /api/v5/trade/orders-history-archive在環境之間傳回一致的分頁結構。

5. 確認books50-l2-tbt頻道的 WebSocket 訂閱可提供即時深度更新，且不會出現驗證錯誤。

歐盟用戶的符合 MiCA 的 API 治理

1. 截至 2025 年 1 月 27 日，OKX Europe Ltd 擁有涵蓋所有 30 個 EEA 司法管轄區的完整 MiCA 授權。

2. 基於 EU 的 API 金鑰會自動執行更嚴格的速率限制：每秒 15 個請求，而不是全域預設的 20 個。

3. 貿易端點返回額外的監管標頭，包括X-MiCA-Jurisdiction和X-Compliance-Level 。

4. 所有現貨訂單確認均包含與標的資產的 MiCA 註冊狀態相關的不可變的complianceReferenceId 。

5. 除非透過 MiCA 合規入口網站明確啟用，否則與提款相關的端點對於 EU 金鑰仍處於停用狀態。

常見問題解答

Q：現貨和期貨交易可以使用相同的 API 金鑰嗎？是的，但前提是在建立過程中為兩個 instType 類別啟用了「交易」權限。為了審計的清晰度，建議使用單獨的密鑰。

Q：為什麼我的現貨訂單回傳錯誤代碼58000？這表示所請求的工具已暫停交易。檢查 OKX 官方儀器狀態頁面或使用 instType=SPOT 呼叫GET /api/v5/public/ instruments 。

Q：密碼區分大小寫嗎？是的。 OKX 儲存其 SHA-256 雜湊值，大小寫的任何變更都會產生無效簽章。

Q：如何驗證我的 API 金鑰是否已外洩？查看 API 管理中的「最近活動」標籤。無法辨識的 IP、意外提款嘗試或訂單取消量激增訊號暴露。