如何查看您在 OKX 上的 SOL 訂單歷史記錄？

透過 OKX REST API 存取 SOL 訂單歷史記錄

1. 使用instId設定為「SOL-USDT」的order_history端點或其他SOL交易對。

2. 對於現貨訂單，將 instType 指定為「SPOT」；對於涉及 SOL 的保證金訂單，將 instType 指定為「MARGIN」。

3. 將限制參數設為 1 到 100 之間，以控制每個請求的回應大小。

4. 在 HTTP 標頭中包含有效的 API 憑證：OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-TIMESTAMP 和 OK-ACCESS-PASSPHRASE。

5. 使用 HMAC-SHA256 透過連接字串建立簽章：'GET' + '/api/v5/trade/order-history' + 時間戳 + 請求正文（GET 為空）。

處理完整 SOL 訂單記錄的分頁

1. 初始請求最多返回 100 個訂單，其中「after」欄位包含最新訂單 ID。

2. 後續請求必須包含先前回應中的「after」值，以取得較舊的訂單。

3. 重複，直到回應資料數組為空或包含的條目少於請求的限制條目。

4. 避免硬編碼分頁邏輯－將「after」視為不透明遊標，而不解析其內部結構。

5. 在合併之前單獨儲存每個批次，以防止在大量歷史檢索期間記憶體溢出。

SOL 訂單的正確參數格式

1. 確保 instId 與 OKX 使用的命名約定完全符合：「SOL-USDT」、「SOL-BTC」或「SOL-USDC」。

2. 下訂單或查詢訂單時，價格和尺寸欄位使用Decimal而不是float，以避免精度損失。

3. 如果縮小時間範圍，則為前/後過濾器傳遞自 Unix 紀元以來的毫秒時間戳。

4. 過濾與保證金相關的 SOL 訂單時，不要省略 tdMode 參數－它必須是「交叉」或「隔離」。

5. 確認 API 金鑰至少在 OKX 帳戶儀表板的安全設定下啟用了「讀取」權限。

取得 SOL 訂單資料時的常見錯誤

1. HTTP 401 錯誤表示簽章無效、時間戳過期或密碼不符。

2. 代碼為「51000」的 HTTP 400 表示 instId 不存在或拼字錯誤 - 驗證區分大小寫和連字符的使用。

3. 空響應，代碼為“0”，但沒有資料表明保證金訂單的 instType 不正確或缺少 tdMode。

4. 速率限制觸發 HTTP 429 — 尊重 X-Rate-Limit-Remaining 標頭並實現指數退避。

5. OkxParamsException 是由格式錯誤的 Decimal 輸入或相關市場呼叫中不受支援的柱間隔引起的。

常見問題解答

Q：我可以檢索超過 90 天的 SOL 訂單歷史記錄嗎？答：是的。 order_history 端點支援超過 90 天的檢索，取決於帳戶活動和 OKX 的保留策略。目前的 V5 規範中沒有記錄明確的截止。

Q：order_history 是否包括已關閉、已取消和已拒絕的 SOL 訂單？答：是的。包括除部分完成的訂單之外的所有訂單狀態。部分成交的訂單僅在活躍時出現；歷史部分填充在取消或完成後不會保留。

Q：是否有 WebSocket 替代方案可用於即時 SOL 訂單更新？答：是的。使用具有正確身份驗證的 WebSocket 訂閱 /private/orders 頻道。這無需輪詢即可提供即時訂單狀態變更。

Q：為什麼某些 SOL 訂單在回應中顯示不同的費用貨幣？答：費用幣種取決於交易模式：現貨訂單使用基礎資產或報價資產作為費用，槓桿訂單則可能根據配置從借入資產或帳戶餘額中扣除費用。