概覽

簡介

Open API V5 將 Bybit 所有業務線，包括現貨/期貨/期權的業務能力整合為一套 Open API

當前各版本的 API 當前覆蓋業務範圍：

OpenAPI 版本	帳戶屬性	正向			反向		現貨	期權
		USDT永續	USDC永續	USDC交割	永續	交割
V5	統一帳戶1.0	✓	✓	✓	見註釋		✓	✓
	統一帳戶2.0	✓	✓	✓	✓	✓	✓	✓
	經典帳戶	✓			✓	✓	✓

注: 統一賬戶1.0支持反向交易, 但是反向合約交易走得是經典帳戶鏈路, 通過反向合約錢包進行交易
統一帳戶2.0將反向交易合併進了統一帳戶, 保證金共用

主要提升能力：

業務線整合

V5 版本將交易產品的 API 合併成一套 API，實現一套 API 可以交易現貨/期貨/期權的業務能力，通過不同的下單參數進行交易區分，無論訂單管理，查詢錢包數據等， 採用同一個 API 都是相同格式的請求和返回結果。不需要切換多套接口來構建不同業務模型。

並且在 V5 中對全局字典做了唯一的定義，避免不同業務線對統一業務場景採用不同命名，或者同一命名有不同含義的問題。減少客戶對接時的困擾。

舉例說明：下單時統一使用 POST V5/order/create ，在 body 中輸入具體的請求業務類型（通過 category=spot/linear/inverse/option 來區分），即可進行多個業務線的下單操作。

提升資金利用率

原有的 API 不同版本對應不同的賬號，每個業務線都有一個賬號，不同賬號直接要通過劃轉調撥資金來管理。 V5 中，提供了賬戶升級成統一賬戶能力，使得賬戶內 的資金可以共享，交易者可以獲得更高的資金利用率。對應現貨/ 反向合約/ USDT 永續/ USDC永續/期權共用一個賬戶資金，同時不同業務線的盈虧可以互相抵消，進一步提高 資金的利用效率。

支持統一賬戶借貸：

API V5 對統一賬戶模式的支持，新增借貸能力。客戶可以使用多個資產作為抵押品作為保證金來交易全業務線。 舉例：只存入 BTC 資產，進行以 USDT 結算的BTCUSDT 合約交易，如果產生浮動盈虧會通過借貸方式記錄負債，產生的負債會每個小時收取利息。

Paradigm大宗交易

統一賬戶現在支持通過 Paradigm 進行大宗交易。用戶可以跨不同產品使用資金

支持組合保證金

統一賬戶下支持 反向合約, USDT永續, USDC永續, USDC交割和期權的組合保證金模式。

接口命名規範

V5 版本的 API 接口路徑定義更明確，從實際場景出發，分為市場數據，訂單管理，持倉管理，賬戶管理，資產管理等模塊，通過更清晰的路徑定義來減少業務歧義。

{host}/{version}/{product}/{module}
舉例: api.bybit.com/v5/market/recent-trade

地址分段	說明
v5/market/	交易產品的K線，深度，行情，平台成交等數據，以及基礎金融規則，風控規則
v5/order/	交易產品的訂單管理
v5/position/	衍生品的持倉管理
v5/account/	單一賬戶的錢包，費率等，僅用於單個賬戶的業務
v5/asset/	資產管理，資金流水，主要是跨不同賬戶的業務場景
v5/spot-lever-token/	現貨槓桿代幣的行情，申購贖回業務
v5/spot-margin-trade/	現貨全倉槓桿模式管理

增加按照結算貨幣取消所有訂單

取消訂單時，支持通過 settleCoin 取消所有期貨合約的訂單數據，不需要按照每個 symbol 來逐次取消。

增加資金費率歷史記錄查詢

V5 升級為可查詢歷史資金費率變化情況，客戶可進行歷史 Funding 回測。

增加保險基金接口

V5 中增加保險池的變更接口查詢，可以查詢 Bybit 平台所有保險基金幣種的變更信息。

數據精度統一規範

V5 版本，返回的所有數值都是實際數值，您不需要做轉換調整。

Open API 文檔可讀性提升

Open API 文檔梳理和校對，將大部分之前文檔描述不清晰的部分進行了改善，減少客戶對接的困惑。