如何查看OKX歷史期貨訂單

透過 OKX Web 介面存取歷史期貨訂單

1. 登入您的OKX帳戶並導覽至期貨交易部分。

2. 點選交易介面頂部的「訂單」標籤。

3. 選擇歷史記錄子標籤以顯示已完成、已取消和已過期的期貨訂單。

4. 使用日期範圍篩選器指定擷取的開始和結束時間戳記 - 預設視窗涵蓋過去 90 天。

5. 應用 BTC-USDT-SWAP 或 ETH-USDT-QUARTER 等工具過濾器，以合約類型和標的資產縮小結果範圍。

透過 REST API 檢索期貨訂單歷史記錄

1. 使用有效憑證從python-okx初始化TradeAPI類，並為生產環境設定flag='0' 。

2. 呼叫get_orders_history_archive方法，傳入參數instType='SWAP' 、 instId='BTC-USDT-SWAP' 、 limit=100 。

3. 使用before參數對回應進行分頁 - 該值是從每個批次中最舊記錄的ordId欄位中提取的。

4. 解析傳回的 JSON 結構：每個條目包含ordId 、 px 、 sz 、 side 、 state 、 fillSz 、 avgPx和ts （毫秒時間戳記）。

5. 在反轉預設的降序排序後，按時間順序儲存原始回應，然後透過檢查連續頁面上ts值的間隙來驗證完整性。

資料完整性和時間範圍約束

1. OKX 在網頁介面上保留期貨訂單歷史長達180 天，但機構級帳戶的 API 存取權限可延長至365 天。

2. 超過 90 天的記錄需要明確的instType規格 - 省略它會傳回空數據，即使提供了instId 。

3. state欄位包括filled 、 cancels 、 partial_filled 、 expired 、 failed等值；失敗表示因保證金不足或參數無效而拒絕訂單。

4. 時間戳始終採用UTC，並且不會根據夏令時進行調整；本地時間轉換必須在客戶端使用 Python 中的datetime.timezone.utc進行處理。

5. 訂單 ID 是不可變的字串，以ORD為前綴，後面跟著 18 個字母數字字元 - 跨批次不存在數字序列保證。

歷史訂單檢索過程中常見的陷阱

1. 使用get_orders_history而不是get_orders_history_archive僅產生最近 90 天的數據，無論分頁嘗試如何。

2. 傳遞無效的before值（例如不存在的ordId或超過 365 天的 ordId）會觸發錯誤代碼50015 （「前參數無效」）。

3. 指定instId時省略instType將傳回帶有空data數組的 HTTP 200，而不是拋出明確驗證錯誤。

4. 將flag='1' （演示模式）與生產instId值混合會導致靜默不匹配 - 在演示模式下放置的訂單永遠不會出現在真實帳戶歷史記錄端點中。

5. 假設已成交訂單的fillSz等於sz ，會忽略強平觸發執行中的部分成交，其中由於級聯市場影響， fillSz可能會超過原始sz 。

常見問題解答

Q：我可以在沒有 API 金鑰的情況下檢索歷史期貨訂單嗎？不需要。 /api/v5/trade/orders-history-archive下的所有端點都需要完整身份驗證，包括OK-ACCESS-KEY 、 OK-ACCESS-SIGN 、 OK-ACCESS-TIMESTAMP和OK-ACCESS-PASSPHRASE 。公共端點不公開訂單歷史記錄。

Q：為什麼orders-history和orders-history-archive回應中都會出現相同的ordId ？當訂單在過去 90 天內下達並且也符合存檔保留條件時，就會發生這種情況。系統維​​護雙索引，但保證重疊記錄的兩個端點上的負載內容相同。

Q： get_orders_history_archive呼叫有速率限制嗎？是的。端點對每個 IP 位址每 2 秒強制執行 20 個請求。超過此限制會觸發 HTTP 429，其中Retry-After標頭指示強制暫停持續時間。

Q：停損市價單如果從未被觸發，是否會出現在歷史訂單記錄中？是的。未觸發的條件訂單將保留在歷史記錄中，如果手動刪除，則state='canceled'如果在到期時間之後仍然有效，則state='pending' ，預設為 30 天，除非在放置期間被覆蓋。