如何在 OKX 上創作 Spot Grid 機器人？

了解現貨網格交易機制

1. 網格交易的運作方式是預先定義價格範圍並將其劃分為均勻間隔的區間（稱為網格）。

2. 每個網格等級都會觸發一個限價訂單：買入訂單位於當前市場價格之下，而賣出訂單則位於當前市場價格之上。

3. 當 BTC-USDT 交易價格在 58,000 美元到 62,000 美元之間時，具有 20 個網格的機器人會在該範圍內下達 10 個買入訂單和 10 個賣出訂單。

4.只有當市場價格達到精確的限價時訂單才會執行－標準網格模式下不會出現滑點。

5. 每個週期的利潤等於網格間距減去交易費用，假設買入和賣出腿都完全執行。

在 OKX 上設定 API 憑證

1. 登入您的 OKX 帳戶並導覽至設定 → API 管理 → 建立 API。

2. 指定一個描述性名稱，在權限下選擇“現貨交易”，並僅啟用“讀取”和“交易”存取權限。

3. 設定 IP 位址白名單，將 API 使用限制為伺服器的靜態 IP 或本機開發電腦。

4. 將產生的 API 金鑰、金鑰和密碼保存在加密憑證儲存中，而不是保存在純文字檔案或版本控制中。

5. 在與程式碼整合之前，使用curl或Postman呼叫GET /api/v5/account/balance和POST /api/v5/trade/order來驗證權限。

使用 python-okx 實現機器人

1. 在 Python 3.9+ 虛擬環境中透過pip install python-okx安裝官方 SDK。

2. 初始化 TradeAPI，使用 flag=0 進行即時模式，並使用 use_server_time=True 以防止時間戳偏差錯誤。

3. 以程式設計方式計算網格參數：從 24 小時價格極值匯出上限和下限，然後將步長計算為 (upper − lower) / grid_count。

4. 在循環中使用tradeAPI.place_order()提交所有買賣訂單，捕獲每個 ordId 以供以後追蹤。

5. 將訂單元資料（包括價格、尺寸、邊數和時間戳記）儲存在本機 SQLite 資料庫或 JSON 檔案中，以進行協調和稽核。

管理訂單生命週期和風險控制

1. 每 30 秒輪詢GET /api/v5/trade/orders-pending以偵測新成交的訂單並觸發後續操作。

2. 買入成交後，自動以價格=filled_price+grid_step下相應的賣出訂單，並調整費用扣除。

3. 在下達新買單之前計算總基礎資產敞口來強制執行頭寸限制，如果超過配置的 max_position_size，則拒絕。

4. 在重新啟動機器人之前，使用帶有 ordId 清單的tradeAPI.cancel_batch_orders()取消所有掛單。

5. 將每個訂單事件（包括建立、填寫、取消和錯誤）記錄到有時間戳記和嚴重性等級的輪調文件。

在即時部署之前驗證機器人行為

1. 在 OKX 的模擬交易環境（flag=1）下，在模擬市場波動下運行機器人至少連續 72 小時。

2. 使用模擬股票流注入人為價格衝擊，以驗證網格重新定位邏輯和停損回退。

3. 將執行的訂單價格與歷史 K 線收盤價進行交叉檢查，以確認與預期的網格水準一致。

4. 測量價格跨越網格閾值和訂單提交之間的延遲 - 超過 800 毫秒的值需要 WebSocket 整合而不是 REST 輪詢。

5. 透過在一秒鐘內提交 25 個訂單來模擬 API 速率限制耗盡，並驗證優雅降級而不會崩潰或資料遺失。

常見問題解答

Q：我可以在同一個 OKX API 金鑰上運行多個網格機器人嗎？答：是的，但每個機器人必須管理自己獨立的一組 ordId，並避免價格範圍重疊，以防止下單衝突。

Q：OKX 是否透過其 API 原生支援尾隨網格？答：不可以。追蹤功能必須在客戶端實現，方法是根據移動價格平均值動態重新計算網格邊界並相應地取消/替換訂單。

Q：機器人如何處理部分填充？答：機器人將部分填充視為該特定訂單的完整執行，記錄實際填充的尺寸，並繼續下達匹配的賣出訂單，該訂單縮放至填充的數量（而不是原始的 sz 值）。

Q：如果市場跳空超出網格範圍會怎麼樣？答：所有未完成的訂單將保持待處理狀態，直到手動或透過機器人的超時程式取消為止；除非明確編碼，否則網格不會自動擴展或收縮。