如何使用BYBIT API進行合同交易？

BYBIT API啟用具有安全身份驗證的自動合同交易，通過WebSocket實時數據以及USDT和反向合同的全訂單管理。

2025/08/11 13:01

了解合同交易的Bybit API

BYBIT API是一種強大的工具，可讓交易者自動在Bybit Exchange上自動化其合同交易策略。通過利用API，用戶可以通過編程訂單，管理職位，檢索市場數據並監視帳戶狀態。首先，必須了解BYBIT支持Restful API和WebSocket API進行實時交互。合同交易的API端點是專門針對USDT永久，逆永久和期貨合約量身定制的。在任何集成之前，請確保您根據打算交易的合同類型訪問正確的API文檔。

首先，請導航到您的BYBIT帳戶設置並生成API密鑰。在此過程中，您必須定義“訂單”，“資產”和“只讀”之類的權限。對於合同交易，需要“訂單”和“職位”權限。切勿在客戶端代碼或公共存儲庫中公開您的秘密密鑰。撥打API調用時，請務必使用HTTP ，以確保安全通信。

設置您的API憑據

要有效地使用BYBIT API，必須首先創建和配置API鍵。登錄到您的BYBIT帳戶，然後訪問您的個人資料下的API管理部分。單擊創建API ，然後將名稱分配給您的密鑰以易於標識。設置權限時：

• 允許貿易許可允許訂單安置和取消
• 啟用職位許可以訪問開放位置並利用設置
• 除非絕對必要以降低安全風險，否則限制提款

創建後，您將收到三個關鍵組件： API密鑰，秘密密鑰和用戶ID 。安全地存儲這些。您還可以設置IP限制，以限制對特定IP地址的API訪問，從而增強安全性。如果您的IP更改，則必須相應地更新白名單。請注意，BYBIT使用HMAC-SHA256進行身份驗證，因此您的請求必須包含正確簽名的消息。

身份驗證的API請求

必須使用您的API密鑰和秘密密鑰對BYBIT的每個私人API請求進行身份驗證。身份驗證過程涉及使用HMAC-SHA256哈希生成簽名。要簽名的字符串通常包括HTTP方法，請求路徑，查詢參數和時間戳。時間戳必須在服務器時間的5秒內，以防止重播攻擊。

這是構建簽名的方法：

• 加入請求方法（例如，post），請求路徑（例如，/v5/order/create）和查詢字符串（如果有）
• 使用您的秘密鑰匙使用HMAC-SHA256哈希串聯字符串
• 用十六進制格式編碼結果
• 在請求標題中以X-BAPI-SIGN包含簽名

所需的其他標頭包括X-BAPI-API-KEY ， X-BAPI-TIMESTAMP和X-BAPI-RECV-WINDOW （可選，默認為5000ms）。不正確的時間戳或簽名會導致身份驗證故障。始終驗證您的系統時鐘與NTP服務器同步。

下達和管理合同訂單

要通過BYBIT API發布合同訂單，請使用/V5/訂單/創建端點。您必須包括基本參數，例如符號，側面（買或出售）， ordertype （限制，市場等），數量和價格（用於限額訂單）。對於USDT劃分的合同，符號格式為BTCUSDT 。對於違反合同，它是BTCUSD 。

要考慮的關鍵參數：

• TimeInforce ：選項包括GoodTillCancel，AmptighoreCancel，Fillorkill
• 減少：設置為true，以確保訂單僅降低位置大小
• Closeontrigger ：可用於停止損失或替代訂單
• positiondx ：對沖模式所需；單程為0，長1，短2

要取消訂單，請使用訂購或OrderLinkID使用/V5/訂單/取消端點。要檢索活動訂單，請使用/V5/訂單/實時。對於職位管理， /v5/位置/列表端點返回當前職位，包括尺寸，入口價格和槓桿作用。使用/V5/位置/設置槓桿調整槓桿。

檢索市場和帳戶數據

實時市場數據對於知情交易決策至關重要。 Bybit為此目的提供了幾個公共終點。使用/V5/Market/Tickers以獲取所有合同的最新價格，資金率和24小時的數量。對於訂單簿數據，使用/v5/market/orderbook帶有符號和深度參數（例如，1、5、50級）。要獲取歷史燭台數據，請使用/V5/Market/Kline與類別，符號，間隔和開始/結束時間。

對於帳戶相關的數據， /v5/帳戶/錢包平衡端點返回所有硬幣的錢包餘額。使用/V5/帳戶/信息獲取總體帳戶詳細信息，包括總權益和可用餘額。要監視最近的訂單填充，請使用/V5/訂單/執行列表。這將返回以價格，數量，費用和出口執行交易。

實施Websocket進行實時更新

對於低延遲交易，請使用BYBIT的Websocket API，而不是輪詢休息端點。連接到USDT合同或wss://stream.bybit.com/v5/public/linear for wss://stream.bybit.com/v5/public/inverse for thersevers合同。要訂閱實時數據，請將帶有OP字段設置的JSON消息發送到“訂閱”，而ARGS數組包含orderBookL2_25.BTCUSDT ， tickers.BTCUSDT或candle.1.BTCUSDT等主題。

對於諸如訂單更新和位置更改之類的私人數據，請驗證WebSocket連接。使用您的API密鑰，時間戳和簽名發送身份驗證請求。經過身份驗證後，訂閱order ， position和execution主題以接收實時更新。 Websocket消息使用ZLIB壓縮，因此在解析之前對其進行解壓縮。

常見問題

BYBIT API的速率限制是多少？

BYBIT執行限制以防止濫用。對於REST API，限制通常為每個API密鑰每秒60個請求。超過此結果在HTTP 429錯誤中。 Websocket連接允許更高的吞吐量，但也受到基於訂閱計數和消息頻率的限制。

如何處理諸如“無效簽名”之類的API錯誤？

確保您的秘密密鑰是正確的，不要修剪。驗證簽名字符串包括確切的方法，路徑和參數。檢查時間戳是否為毫秒，在BYBIT服務器時間的5秒內。使用https://api.bybit.com/v5/market/time獲取當前服務器時間。

我可以將BYBIT API用於電網交易還是DCA機器人？

是的，API支持自動化策略。使用/v5/order/在循環中以不同的價格和數量創建。實施邏輯以取消陳舊的訂單並根據市場條件調整位置。確保您的機器人處理資金付款和清算風險。

測試網絡可用於API合同交易嗎？

是的，Bybit在https://api-testnet.bybit.com上提供了測試網環境。使用它來模擬交易，而不會冒著實際資金的風險。為TestNet生成單獨的API鍵。所有終點都反映了實時環境，允許進行完整的策略測試。