如何使用Bybit API？

BYBIT API可以通過安全的REST和WebSocket端點啟用自動交易，實時數據流以及位置管理。

2025/08/04 23:42

了解Bybit API及其用例

BYBIT API是一個強大的接口，允許交易者和開發人員以編程方式與Bybit的交易平台進行交互。它可以自動化交易策略，實時市場數據檢索，訂單放置，職位管理和帳戶餘額監控。 API支持RESTFUL和WEBSOCKETS協議，為不同的用例提供了靈活性。 REST API是一次性請求的理想選擇，例如下訂單或支票餘額，而Websocket最適合連續數據流，例如實時價格更新或訂單簿更改。在使用API之前，用戶必須從其BYBIT帳戶中生成API密鑰，該鍵是身份驗證憑證。

生成您的bybit API密鑰

要開始使用BYBIT API，必須首先創建一個API鍵。此過程直接在您的BYBIT帳戶儀表板中完成。在您的個人資料設置下導航到API管理部分。單擊創建API ，將提示您輸入API鍵的名稱並設置IP限制。 IP白色列表通過限制API訪問指定的IP地址來增強安全性。輸入所需的詳細信息後，BYBIT將生成一對憑據： API密鑰和一個秘密密鑰。這些必須安全存儲，因為初始創建後不會再次顯示秘密密鑰。切勿共享這些鍵或以客戶端代碼暴露它們。

為請求配置API身份驗證

BYBIT API中的所有私人端點都需要使用API密鑰和秘密密鑰進行身份驗證。身份驗證是通過HMAC SHA256簽名實現的。每個請求必須包括特定的標題：

• X-BAPI-API-KEY ：您的API密鑰
• X-Bapi-Sign ：生成的簽名
• X-Bapi-Timestamp ：當前的時間戳以毫秒為單位
• X-BAPI-RECV-WINDOW ：可選，定義請求有效性的時間窗口（默認為5000ms）

要生成X-BAPI-SIGN ，請以特定順序（Timestamp + api_key + recv_window + query_string）加入請求參數，然後使用HMAC SHA256與您的秘密密鑰一起使用它們。大多數編程語言為此提供內置庫。例如，在Python中，使用hmac和hashlib模塊。確保時間戳與BYBIT的服務器時間同步，以避免簽名錯誤。

使用REST API下訂單

要通過BYBIT API進行交易，請將郵政請求發送到適當的端點，例如/v5/order/create 。必需的參數包括：

• 符號：交易對，例如， btcusdt
• 側面：買賣
• OrderType ：例如極限，市場或停止
• 數量：交易數量
• 價格：限額訂單的要求
• TimeInforce ：指定執行說明，例如， GTC （良好直到取消）

在發送請求之前，請確保正確格式化所有參數並包含在簽名計算中。成功的響應將返回包含OrderID ， OrderLinkID和狀態的JSON對象。始終驗證響應代碼和消息以確認執行。使用OrderLinkid在隨後的查詢中跟踪您的訂單。

使用WebSocket流式傳輸實時數據

對於需要實時更新（例如算法交易機器人或市場監控儀表板）的應用程序，bybit的Websocket API至關重要。連接到Websocket端點： wss://stream.bybit.com/v5/public/linear for USDT永久合同。建立連接後，使用訂閱消息格式訂閱主題。示例包括：

• orderbookl2_25.btcusdt ：前25個訂單簿級別
• tickers.btcusdt ：實時股票數據
• Candle.1.btcusdt ：1分鐘燭台數據
• publictrade.btcusdt ：最近的交易

收到的每個消息將包含一個主題字段和數據有效載荷。相應地解析JSON響應。對於私人數據（例如位置或餘額更新），請建立與私人端點的單獨的Websocket連接，並包括類似於REST的身份驗證標頭。

通過API管理職位和風險

BYBIT API允許完全控制開放位置。要檢索當前職位，請將get請求發送到/v5/position/list 。響應包括尺寸，入門額，未實現的PNL和槓桿作用。要修改位置，例如調整停止損失或付費級別，請使用/v5/position/trading-stop端點。必需參數：

• 象徵
• Stoploss ：停止損失價格
• TakeProfit ：賣方價格

確保這些值在允許的價格範圍內和帳戶槓桿設置範圍內。要結束職位，請按相同數量的相對的市場訂單下達對立的市場訂單。例如，如果您持有1 BTC的買入頭寸，請發送1 BTC的賣出市場訂單。通過檢查下一個位置查詢中更新的位置大小來確認關閉。

常見問題

如何重置我的Bybit API秘密密鑰？

BYBIT不允許直接重置秘密鍵。您必須刪除現有的API密鑰並創建新的API密鑰。導航到API管理，找到密鑰，單擊刪除，確認操作，然後生成新的密鑰對。立即使用新憑據更新您的應用程序。

我可以在沒有IP限制的情況下使用BYBIT API嗎？

是的，但是這是高度灰心的。殘留IP限制會使您的API密鑰暴露於潛在的濫用中。如果必須禁用它，請確保您的應用程序使用其他安全層，例如加密存儲和最少的權限範圍。

BYBIT API適用於什麼速率限制？

BYBIT執行限制以防止濫用。 REST API每個IP最多允許每秒60個請求。 WebSocket連接每個連接最多24個訂閱。超過極限會導致429誤差。在多個IP上分發請求，或在可能的情況下使用批處理。

為什麼我會遇到“無效的簽名”錯誤？

這通常是由於不正確的參數排序，時間戳不匹配或錯誤的哈希方法而發生的。驗證時間戳是否匹配X-Bapi-Timestamp標頭，參數在詞典上進行排序，並且HMAC SHA256與正確的秘密鍵一起使用。用簡單的端點進行測試，例如/v5/user/query-api ，以隔離問題。