如何使用Bybit API交易？開發者入門指南

API存取和金鑰管理

1.透過官方網站或桌面應用程式登入您的Bybit帳號。

2. 導覽至帳戶設定 → API 管理 → 建立 API 金鑰。

3. 指定一個描述性名稱，選擇IP白名單限制，並僅啟用必要的權限，例如「唯讀」、「交易」或「提現」。

4. 使用2FA確認建立；將 API 金鑰和 API 秘密離線儲存在加密保管庫中。

5. 切勿在前端程式碼、瀏覽器控制台或公共儲存庫中公開 API Secret。

支援的 API 版本和端點

1. Bybit V5 REST API以統一的結構和一致的回應模式為現貨、衍生性商品和資產端點提供服務。

2. WebSocket公共通道提供即時市場數據，包括訂單簿深度（orderbook.50）、股票代號（tickers）和交易執行（publicTrade）。

3. WebSocket私有通道支援倉位更新、訂單狀態變更、錢包餘額通知和執行報告。

4. 統一交易帳戶端點允許跨現貨和衍生性商品進行全倉操作，無需手動轉帳。

5. 所有端點都需要嚴格的時間戳同步－時鐘偏差超過30秒會觸發拒絕。

身份驗證工作流程

1. 每個請求必須包含 X-BAPI-API-KEY 標頭，其中包含您的活動 API 金鑰。

2. X-BAPI-SIGN 標頭攜帶連接字串的 HMAC SHA256 哈希：時間戳 + api_key + recv_window + Payload 。

3. X-BAPI-TIMESTAMP 標頭包含目前 Unix 時間戳記（以毫秒為單位）。

4. X-BAPI-RECV-WINDOW 定義簽章驗證可接受的時間窗口，預設為 5000 ms。

5. 簽章前，有效負載必須採用 JSON 序列化，不含空格，並依字典順序對金鑰進行排序。

速率限制和錯誤處理

1. REST API 強制公用端點的每個 API 金鑰每分鐘 120 個請求，私有端點每分鐘 60 個請求。

2. WebSocket 連線限制為每個連線 100 個訂閱；超過觸發自動中斷。

3. HTTP 429回應表示速率限制耗盡；客戶端必須實現指數退避和抖動。

4. 常見錯誤碼包括10001（簽章無效）、10002（時間戳過期）、30087（餘裕不足）。

5. 所有錯誤主體都包含 retCode、retMsg 和其他上下文字段，例如用於調試的 orderId 或符號。

常見問題解答

Q：測試網和主網可以使用相同的 API 金鑰嗎？不需要。測試網和主網需要從各自的網域產生單獨的 API 金鑰。 https://api-testnet.bybit.com 上發布的金鑰在生產中無效。

Q：Bybit 是否支援 Webhook 整合來執行訂單？不可以。 Bybit 不提供 webhook 傳送。用戶端必須維護持久的 WebSocket 連線或輪詢 REST 端點以取得填入確認。

Q：是否可以透過程式撤銷 API 金鑰？是的。使用具有有效身份驗證的 DELETE /v5/user/api-key 端點。此操作需要目標金鑰的 ID 且無法撤銷。

Q：Bybit 是否有官方維護的 Python 或 JavaScript 的 SDK？ Bybit 在 GitHub 上提供社群支援的 SDK，但不發布或認可任何官方維護的特定於語言的程式庫。開發人員依賴第三方維護的 pybit 和 bybit-api 套件。