Guides Bybit 用戶指南

如何創建和設置 Bybit API 密鑰

中級
Bybit 用戶指南
2023年9月14日

如今,交易 API 因其功能多樣且定製化程度高而被廣泛使用。集成交易 API 在實現自動化方面尤其有用,可賦能交易者高效管理其投資組合、分析市場趨勢或實施複雜的交易策略。隨着加密貨幣市場的不斷髮展與用戶需求的日益增長,越來越多的產品升級和功能正在進行集成,包括 Bybit API。

本指南將為您介紹如何將 Bybit API 集成至其他自動化交易應用程序。

要點一覽:

  • API 和 API 密鑰協同工作,讓各類軟件應用程序能夠彼此交互。

  • Bybit 提供眾多 API,包括 WebSocket API、REST API 和歷史行情數據 API 等。

  • Bybit API 優勢眾多,既可以讓用戶自定義用戶界面和偏好設置,還可以實現跟單交易策略自動化,提高用戶的交易速度和準確性。

什麼是 Bybit API?

Bybit API 是一組應用程序編程接口 (API),可供開發人員透過編程方式與 Bybit 平台進行交互。Bybit 作為一流的加密貨幣衍生品交易平台,提供豐富的数字資產交易選擇。藉助 API,開發人員可以訪問市場數據、管理訂單、執行交易以及訂閱數據流。

Bybit API 有多個版本,可滿足不同產品和功能的需求。例如,V3 API 支持現貨、USDC 永續和期權合約交易,而 V2 API 則支持反向永續和交割合約交易。為最大限度地提高安全性,Bybit API 採用 HMAC加密技術進行身份認證。開發人員可使用一系列工具和語言集成 Bybit API,包括 Python、Node.jsWebSocket

API 與 API 密鑰對比

API 是指採用一組不同規則和語言的通信協議,讓各類軟件應用程序能夠彼此交互。例如,Web API 使用 HTTP 協議,可供開發人員透過 JSON 和 XML等常用數據格式訪問網絡資源。

相比之下,API 密鑰可以公鑰或私鑰的形式出現。API 密鑰充當身份認證密鑰或訪問令牌,它們是一串獨一無二的字符,作為用戶請求訪問 API 功能時的一種身份認證方式。API 密鑰由 API 的供應商生成,主要用於追蹤不同客戶端或應用程序對 API 的使用情況。

Bybit V3 API 與 V5 API 對比

Bybit V3 API 是 Bybit API 的上一個版本,支持普通和統一賬戶的線性和反向合約。而 Bybit V5 API 是 Bybit API 的最新版本,支持現貨、衍生品和期權合約 Bybit 統一交易賬戶

V3 API 和 V5 API 的區別如下:

  • Bybit V3 API 僅涵蓋特定的交易產品,其他產品均有自己專屬的一套 API。相比之下,V5 API 集成了各類交易產品的 API,讓用戶能夠透過單個 API 交易現貨、衍生品和期權合約。

  • 與 V3 API 不同的是,Bybit V5 API 允許用戶將其賬戶升級為統一交易賬戶,這樣一來,不同合約類型之間即可實現資金的共享和交叉使用。

  • 藉助 V5 API,用戶可以在統一交易賬戶模式下借款,還可以使用多種資產作為抵押品,從而獲取交易不同產品的保證金。

  • 此外,V5 API 還支持將統一交易賬戶中 USDT 永續、USDC 永續、USDC 交割和期權合約倉位的保證金合併計算。

由於 Bybit V5 API 基於 V3 API 創建,用戶只需調整 URL 和接口字段即可輕鬆從 V3 API 升級至 V5 API。

瞭解詳情:Bybit API 文檔(API 文檔)

如何在 Bybit 上創建 API 密鑰

要在第三方應用程序中使用 Bybit,必須先在 Bybit 平台上創建 API 密鑰。但在此之前,瞭解 IP 速率限制至關重要。

IP 速率限制簡介

IP 速率限制會根據輸入請求的 IP 地址調節網絡流量,防止用戶在特定時間範圍內過於頻繁地重複操作。針對公開數據、私人數據和下單等不同的請求類型,Bybit 設有不同的速率限制。

如果您超出了特定請求類型的速率限制,您將收到錯誤代碼,且您的請求會被拒絕。為避免此種情況,您必須監控請求頻率並進行相應的調整。此外,對於某些請求類型,請考慮使用 WebSocket API 而非 REST API,因為 WebSocket 請求不計入速率限制。

綁定 API 的分步指南

要在第三方應用程序或平台上使用 Bybit API,首先需要在 Bybit 平台上創建一個 API 密鑰,然後將該密鑰綁定至目標平台。請按照以下步驟操作:

  1. 登錄 Bybit 賬戶註冊一個 Bybit 賬戶。

  2. 點擊頁面右上角的賬戶圖標,然後從下拉菜單中選擇 API

  3. 前往 API 管理選項卡,然後點擊新建密鑰

  4. 選擇系統生成的 API 密鑰自行生成的 API 密鑰

  5. 選擇綁定第三方應用,然後從下拉菜單中選擇第三方應用程序,並命名該 API 密鑰

  6. 設置 API 密鑰權限(如賬戶信息、下單和倉位信息),然後點擊提交

  7. 複製該 API 密鑰和密鑰密碼,並將其妥善保存

  8. 登錄第三方應用程序,並綁定該保存的 API 密鑰。

如何在 3Commas 平台上綁定 Bybit API

若您希望在 3Commas 加密貨幣交易平台上使用 Bybit,請先使用 API 密鑰進行綁定。具體步驟如下:

  1. 登錄 Bybit 賬戶註冊一個 Bybit 賬戶

  2. 點擊頁面右上角的賬戶圖標,然後從下拉菜單中選擇 API

  3. 前往 API 管理選項卡,然後點擊新建密鑰

  4. 選擇系統生成的 API 密鑰

  5. 選擇綁定第三方應用,然後從「應用名稱」下拉列表中選擇 3Commas

  6. 設置 API 密鑰權限,包括賬戶信息、下單和倉位信息等(如果您只希望透過 3Commas 查看賬戶數據,也可以選擇只讀)。

  7. 點擊提交,即可生成 API 密鑰。您的 API 密鑰和密鑰密碼將顯示在頁面上。您可以將其複製到剪貼板或將其作為文件下載。

  8. 登錄 3Commas 賬戶或創建一個新的 3Commas 賬戶。

  9. 前往我的交易所頁面,然後點擊添加交易所

  10. 從支持的交易所列表中選擇 Bybit,然後輸入您在 Bybit 上生成的 API 密鑰和密鑰密碼。您還需要輸入您的客戶 ID,該 ID 可以在 Bybit 平台的修改密碼頁面上找到。

  11. 點擊連接,即可將您的 Bybit 賬戶綁定至 3Commas 平台。

完成上述步驟後,您即可在 3Commas 平台上使用 Bybit,訪問各類交易工具和功能。如果您需要更新或刪除您的 API 密鑰,可以在 Bybit 的「API 管理」頁面或 3Commas 的我的交易所頁面執行此操作。

如何在 Insilico 平台上綁定 Bybit API

Insilico 是一個加密貨幣交易平台,它提供如交互式圖表、訂單簿、交易、工具、活動、訂單、倉位、設置、配置、執行面板和側板等一系列工具和功能。

如需將您的 Bybit 賬戶綁定至 Insilico,請按以下步驟操作:

  1. 登錄 Bybit 賬戶,然後點擊頁面右上角的賬戶圖標。

  2. 點擊頁面右上角的賬戶圖標,然後從下拉菜單中選擇 API。

  3. 前往 API 管理選項卡,然後點擊新建密鑰

  4. 選擇系統生成的 API 密鑰

  5. 選擇綁定第三方應用,然後從「應用名稱」下拉菜單中選擇 Insilico Terminal。該操作可確保密鑰鎖定在 Insilico 的服務器 IP 範圍內。

  6. 設置 API 密鑰權限,包括賬戶信息、下單和倉位信息等。若您只希望在 Insilico 上查看賬戶數據,還可以選擇只讀

  7. 點擊提交,即可生成 API 密鑰。您的 API 密鑰和密鑰密碼將顯示在頁面上。您也可以將其複製下來或下載為文件進行保存。

  8. 登錄 Insilico 賬戶(或創建一個新的 Insilico 賬戶)。

  9. 前往設置頁面,然後點擊添加交易所

  10. 從支持的交易所列表中選擇 Bybit,然後輸入您在 Bybit 上生成的 API 密鑰和密鑰密碼。您還需要輸入您的客戶 ID,該 ID 可以在 Bybit 平台的修改密碼頁面上找到。

  11. 點擊連接,即可將您的 Bybit 賬戶綁定至 Insilico。

我可以使用 Bybit 測試環境進行 API 測試嗎?

可以。您可以隨時使用 Bybit 測試環境進行 API 測試,但由於數據和交易並不真實,可能無法反映實際市場行情。Bybit 測試環境又稱測試網,它是一個虛擬交易平台,可供用戶測試個人 API 策略和代碼,而無需承擔資金損失風險。用戶可以透過 Bybit 測試環境訪問 Bybit API 服務,如 REST API、WebSocket API 和歷史行情數據。

Bybit API 類型

Bybit API 接口分為以下三類:

REST API

REST API 接口可以讓用戶使用 HTTP 方法(如 GET、POST、PUT 和 DELETE)發送請求和接收響應。您可以使用 REST API 在 Bybit 平台上執行各種操作,包括查詢行情數據、下單、修改訂單以及查看倉位。REST API 非常適合低頻高延遲請求。

WebSocket API

WebSocket API 接口可以讓用戶與 Bybit 服務器建立持久連接,還可以讓用戶使用 WebSocket 協議接收實時更新。依託 WebSocket API 及配套的 WebSocket 數據,您可以訂閱各類市場和私人數據主題,如訂單簿、K 線、交易、資金費率、訂單狀態和倉位狀態等。WebSocket API 最適合高頻低延遲請求。

瞭解詳情:訂閱 WebSocket API

歷史行情數據

您可以透過 CSV 格式下載公開的歷史行情數據,還可以使用這些數據來回測交易策略與分析市場趨勢。歷史行情數據包括訂單簿快照、K 線數據、交易數據和資金費率數據。

瞭解詳情:點擊此處下載 Bybit 行情數據 API。

Bybit API 的優勢

Bybit API 是一款功能十分強大的工具,可助力您改善交易體驗、提升交易表現。Bybit API 的優勢如下:

  • 快速準確地自動執行交易策略。藉助 Bybit API,您可以創建和運行交易機器人,讓這些機器人代您執行各類操作,包括下單、修改和取消訂單,以及根據您預設的邏輯和參數管理倉位。此外,Bybit API 還可以讓您集成第三方交易工具和功能。

  • 訪問實時和歷史行情數據。您可以訂閱各類市場數據主題,並使用 WebSocket API 接收實時更新。您可以透過 CSV 格式下載公開的歷史行情數據,進而使用這些數據分析市場趨勢、識別交易機會以及回測交易策略。

  • 自定義用戶界面和偏好設置。您可以自由創建專屬的用戶界面和看板,並根據自身需求選擇要顯示的信息和功能。您還可以調整個人設置和配置,如保證金模式、槓桿水平和風險限額等。

Bybit API 是否收費?

Bybit 用戶可免費使用 Bybit API,無需支付任何額外費用。但您在 Bybit 平台開展交易時,仍需支付常規的交易手續費和資金費用。

結語

Bybit API 為開發人員提供了非常有效的工具和接口,讓其可以透過代碼與 Bybit 平台進行交互。藉助這些工具,您可以自動執行交易策略、訪問實時行情數據以及自定義用戶界面。

只需按照上述步驟操作,您即可在 Bybit 平台上設置 API 密鑰,並將其綁定至 3Commas 或 Insilico 等第三方應用程序。需要注意的是,Bybit V3 API 和 V5 API 之間存在差異,且您需要遵守 IP 速率限制,方可實現無縫交易。