如何建構Bybit交易機器人：開發者技術指南

Bybit API架構概述

1. Bybit 的 REST 和 WebSocket API 在嚴格的速率限制框架上運行，其中每個端點屬於特定的權重層 - 公共端點（例如股票行情和訂單簿查詢）每次調用消耗 1 個單位，而私有端點（例如下單或倉位修改）則根據負載複雜性攜帶 3 到 10 個單位的權重。

2. 驗證依賴於使用金鑰、時間戳記和規範化請求字串產生的 HMAC-SHA256 簽章；隨機數對齊或簽章過期視窗（最多 30 秒）中的任何不符都會立即觸發 401 未經授權回應。

3. v5 API引入了跨現貨、反向永續、線性永續和選擇權市場的統一保證金模式支援－這需要在每個請求標頭中明確指定類別參數，以避免模糊的路由錯誤。

4. 訂閱私有頻道前必須建立WebSocket連線並進行強制認證握手；連線後10秒內未能發送auth資料包將導致強制終止。

5. 訂單生命週期事件（包括創建、部分填充、完全填充、取消和拒絕）透過不同主題（如訂單、執行和持倉）下的單獨流發出，需要每個主題進行獨立的訂閱管理。

核心整合組件

1. ccxt.bybit連接器透過解析 X-RateLimit-Remaining 標頭並在閾值低於分配配額的 20% 時動態限制後續請求來處理自動速率限制自適應。

2.保證金模式切換邏輯位於exchange_instance_service.ts模組中，該模組強制隔離保證金配置和跨保證金配置之間的原子狀態轉換，而不向最終用戶公開原始API呼叫。

3. 透過orderBookL2_25 WebSocket 流檢索訂單簿深度快照，提供按價格排序的出價/要價水平，並在每個更新負載中嵌入微秒級精度的時間戳。

4. 位置同步使用基於增量的協調：機器人將本地快取校驗和與每個位置更新事件中返回的伺服器端位置版本號進行比較，以檢測和解決不一致情況，而無需完全狀態重新載入。

5. 交易執行驗證發生在三層——提交前參數清理、回應後狀態代碼驗證以及透過執行流關聯的填充後確認——確保沒有未確認的訂單停留在不明確的狀態。

策略執行機制

1. 基於 Bybit 線性永續合約建構的趨勢追蹤策略直接根據透過GET /v5/market/candles取得的蠟燭資料計算 EMA(9) 和 EMA(21) 值，間隔解析度可配置低至 1 分鐘。

2. 使用設定為 Partial 的tpSlMode參數，以原子方式與掛單一起提交停損和止盈水平，從而能夠根據即時 ATR(14) 計算動態調整追蹤停損。

3. 資金費率套利邏輯同時監控多個交易品種的GET /v5/market/funding/history端點，僅當絕對資金差在連續三個時間間隔內超過 0.025% 時才觸發對沖頭寸。

4. 清算風險評估將來自walletBalance串流的即時帳戶淨值更新與未平倉部位名義值結合，每 200 毫秒計算一次保證金比率。

5. 時間加權平均價格 (TWAP) 執行將大訂單拆分為固定大小的子訂單，這些子訂單以可配置的間隔間隔，每個子訂單的價格源自當前中間價格加上根據最後 5 秒訂單簿深度計算的滑點緩衝區。

錯誤處理和恢復協議

1. 網路斷開偵測使用雙層監控：作業系統層級的 TCP 保持活動逾時與所有活動 WebSocket 連線上每 15 秒進行一次應用程式層級 ping/pong 心跳驗證相結合。

2. 失敗的訂單提​​交會觸發指數退避重試序列，上限為五次嘗試，並應用抖動來防止分散式機器人實例之間的同步重試。

3. 無效簽章錯誤會立即啟動重新驗證流程，如果 60 秒視窗內重複失敗次數超過 3 次，則會丟棄快取的憑證並強制重新產生新的 API 金鑰。

4. 透過 REST GET /v5/market/orderbook請求完整快照，然後透過後續 WebSocket 更新進行增量增量修補，可以修正訂單簿不同步問題。

5. 頭寸不匹配恢復透過POST /v5/position/reset-isolated（對於逐倉保證金帳戶）或POST /v5/position/set-leverage （對於全倉保證金場景）調用強制頭寸重置，以恢復一致的狀態對齊。

安全配置標準

1. API金鑰權限在交易所層級強制執行：交易金鑰必須啟用訂單管理和部位管理，而只讀金鑰僅需要存取帳號資訊。

2. IP 白名單對於生產部署是強制性的 - 任何源自預先批准的 CIDR 範圍之外的請求都會立即收到 403 Forbidden 回應，無論簽名如何。

3. 密鑰使用 AES-256-GCM 加密存儲，每個進程的臨時密鑰每 24 小時輪換一次，即使內存轉儲受到損害，也能防止長期暴露。

4. 所有出站 HTTP 請求均包含設定為 5000 毫秒的X-BAPI-RECV-WINDOW標頭，拒絕任何延遲超過此閾值的伺服器回應，以減輕重播攻擊向量。

5. 雙重認證繞過令牌永遠不會在本地保留 - 它們是在初始設定期間按需產生的，並在成功 API 註冊後立即丟棄。

常見問題解答

Q1：Bybit 的現貨交易和衍生性商品交易可以使用同一個 API 金鑰嗎？是的，但在建立過程中必須明確授予該密鑰兩個類別的權限；嘗試使用僅限現貨的密鑰存取衍生性商品端點會傳回錯誤代碼 10003。

Q2：Bybit如何處理不同交易對之間重複的訂單ID？每個訂單 ID 的範圍僅限於其交易品種——相同的客戶訂單 ID 可能同時存在於 BTCUSDT 和 ETHUSDT 中，不會發生衝突，但衝突檢測嚴格適用於同一交易對上下文。

問題 3：如果我的機器人提交槓桿設定無效的訂單，會發生什麼事？ API 拒絕它並傳回錯誤代碼 30083，並在回應正文中包含準確的允許槓桿範圍，允許立即修正，無需手動幹預。

Q4：有沒有辦法在下大訂單之前以程式方式確定當前市場流動性？是的， GET /v5/market/tickers端點返回 bidSize 和 AskSize 字段，指示帳簿頂部流動性數量，而GET /v5/market/orderbook提供指定價格水平的累積深度。