概覽

簡介

Open API V5 將 Bybit 所有業務線，包括現貨/期貨/期權的業務能力整合為一套 Open API，在 Open API V3 的基礎上進一步統一規範和標準。

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

重要

如果您的帳戶模式仍然是統一保證金(Unified Margin)，則無法通過V5接口交易現貨，強烈推薦升級至最終版的統一帳戶

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

注：統一賬戶支持反向交易。但是，使用的保證金來自反向衍生品錢包，而不是統一錢包。

主要提升能力：

業務線整合

之前存在 Spot V1/V3 ，Futures V2 正向永續/反向永續/反向交割產品各自一套 API，USDC 期權 API V1，每套 API 僅覆蓋部分業務場景。 V5 版本將交易產品的 API 合併成一套 API，實現一套 API 可以交易現貨/期貨/期權的業務能力，通過不同的下單參數進行交易區分，無論訂單管理，查詢錢包數據等，採用同一個 API 都是相同格式的請求和返回結果。不需要切換多套接口來構建不同業務模型。

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

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

升級成本低

API V5 在之前 V3 的標準基礎上升級，如果您已經接入 Contract V3 或者 Unified V3，升級到 V5 之後，僅需要調整至 V5 的 URL，並且少量接口字段做調整即可。具體接口的對比，可以參照下方的接口映射列表。

提升資金利用率

原有的 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/	現貨全倉槓桿模式管理

API Rate Limit 規則調整

API V5 的限頻規則調整為按照業務線分配 User ID 每秒限頻額度，限頻規則調整:

V2 限頻規則：“User ID + Symbol + API End Point” 通過固定的每分鐘計數限制 API 請求頻率
V3 限频规则：“User ID + API End Point” 通过固定的每秒钟计数限制 API 请求频率
V5 限频规则：“User ID + API End Point” 通过固定的每秒钟计数限制 API 请求频率

举例说明:

V2 期貨限頻模式,
- 用戶設置的下單頻率為 BTCUSDT 400/m，ETHUSDT 200/m，其他 symbol 100/m
- 下單 BTCUSDT 200個訂單請求，則在該 1 分鐘內剩餘額度為 200次 BTCUSDT 的訂單請求。 ETHUSDT 在該 1 分鐘內剩餘額度為 200/m，其他 symbol 為 100/m
- 同時又發送 100 個 ETHUSDT 訂單請求，則在該 1 分鐘內剩餘額度為 200次 BTCUSDT 的訂單請求。 ETHUSDT 在該 1 分鐘內剩餘額度為 100次，其他 symbol 為 100/m
V3/V5 限頻模式,
- 默認所有客戶的基礎限頻規則是 10/s
- 舉例：下單頻率提高到 100/s （代表對於單個 UID 來說所有的下單類型的接口峰值就是 100 次請求）
- 下單 BTCUSDT 在該 1s 內使用了 50 次，則其他所有的 symbol 所有的訂單類型的接口在該 1s 內還可以操作訂單 50次
- 下一秒的限頻會重置到 100/s

備註

默認私有接口限頻規則為 10/s，查詢類的接口不可提頻，均為 10/s 的查詢（推薦使用 WS 接收數據）。

交易延遲不變

Open API V5 1月1號目前僅支持統一賬戶交易，交易延遲與原統一保證金交易保持一致。即將開放非統一賬戶交易能力，延遲與 V3 持平。

普通訂單和條件訂單下單合併

合約 V2 版本中，提交活動單和條件單是不同的 API。 V3/V5 合併為一個下單接口，支持不同的提交參數，客戶不需要下不同的訂單請求不同的接口。

增加實時訂單非活動單查詢

原 API V3中只提供了 unfilled order 的實時查詢，V5 中增加了最近 500 條訂單的實時查詢。對於最近剛剛成交的訂單數據，可以實時的查詢到訂單的狀態，相比通過 order/history 接口查詢降低延遲。

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

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

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

原有 V2 的 API 僅支持查詢上個週期的資金費率，V3/V5 升級為可查詢歷史資金費率變化情況，客戶可進行歷史 Funding 回測。

增加保險基金接口

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

增加更多 Websocket 數據

通過提供不同頻率不同檔位的 Orderbook 數據來滿足您不同的業務場景，近盤口提供更快的頻率推送，原有的 25 檔推送頻率不變，提升至 50 檔。具體請參考 websocket 接口文檔的描述。同時 orderbook 中增加可用於校驗數據連續性的 updateId 來判斷 orderbook 的數據是否丟失，用於您維護本地正確的 orderbook。以及增加 seq（Sequence）字段用於您判斷不同檔位推送的數據先後對比，以更快的響應行情變化。

業務線	1檔	25檔	50檔	100檔	200檔	500檔
現貨	10ms	-	20ms	-	-	-
期貨	10ms	-	20ms	-	100ms	100ms
期權	-	20ms	-	100ms	-	-

提升 PostOnly 單筆下單數量

針對期貨業務，提交 Post Only 類型的訂單，可以獲得單筆下單更多的數量，通常是普通訂單數量的 5倍。可以通過衍生品交易規格接口獲取單個 symbol 可以交易的最大下單數量。

數據精度統一規範

在之前的 API 中，會返回 E2 ，E8 類型的數據。在 V3 和 V5 版本，返回的所有數值都是實際數值，您不需要做轉換調整。

Open API 文檔可讀性提升

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

V5 和 V3 接口映射列表：

模塊	V5接口	V3接口
公有行情	/v5/market/kline	/derivatives/v3/public/kline
	/v5/market/kline	/spot/v3/public/quote/kline
	/v5/market/mark-price-kline	/derivatives/v3/public/mark-price-kline
	/v5/market/index-price-kline	/derivatives/v3/public/index-price-kline
	/v5/market/premium-index-price-kline	/derivatives/v3/public/premium-index-price-kline
	/v5/market/orderbook	/derivatives/v3/public/order-book/L2
	/v5/market/orderbook	/spot/v3/public/quote/depth
	/v5/market/tickers	/derivatives/v3/public/tickers
		/spot/v3/public/quote/ticker/24hr
		/spot/v3/public/quote/ticker/price
		/spot/v3/public/quote/ticker/bookTicker
	/v5/market/funding/history	/derivatives/v3/public/funding/history-funding-rate
	/v5/market/recent-trade	/derivatives/v3/public/recent-trade
	/v5/market/recent-trade	/spot/v3/public/quote/trades
	/v5/market/open-interest	/derivatives/v3/public/open-interest
	/v5/market/historical-volatility	/derivatives/v3/public/historical-volatility
	/v5/market/insurance	/derivatives/v3/public/insurance
	/v5/market/instruments-info	/derivatives/v3/public/instruments-info
		/spot/v3/public/infos
		/spot/v3/public/symbols
	/v5/market/risk-limit	/derivatives/v3/public/risk-limit/list
	/v5/market/delivery-price	/derivatives/v3/public/delivery-price
交易	/v5/order/create	/unified/v3/private/order/create
	/v5/order/create	/contract/v3/private/order/create
	/v5/order/amend	/unified/v3/private/order/replace
	/v5/order/amend	/contract/v3/private/order/replace
	/v5/order/cancel	/unified/v3/private/order/cancel
	/v5/order/cancel	/contract/v3/private/order/cancel
	/v5/order/realtime	/unified/v3/private/order/unfilled-orders
	/v5/order/realtime	/contract/v3/private/order/unfilled-orders
	/v5/order/cancel-all	/unified/v3/private/order/cancel-all
	/v5/order/cancel-all	/contract/v3/private/order/cancel-all
	/v5/order/history	/unified/v3/private/order/list
	/v5/order/history	/contract/v3/private/order/list
	/v5/order/create-batch	/unified/v3/private/order/create-batch
	/v5/order/amend-batch	/unified/v3/private/order/replace-batch
	/v5/order/cancel-batch	/unified/v3/private/order/cancel-batch
	/v5/order/spot-borrow-check	無
持倉	/v5/position/list	/unified/v3/private/position/list
	/v5/position/list	/contract/v3/private/position/list
	/v5/position/set-leverage	/unified/v3/private/position/set-leverage
	/v5/position/set-leverage	/contract/v3/private/position/set-leverage
	/v5/position/set-risk-limit	/unified/v3/private/position/set-risk-limit
	/v5/position/set-risk-limit	/contract/v3/private/position/set-risk-limit
	/v5/position/trading-stop	/unified/v3/private/position/trading-stop
	/v5/position/trading-stop	/contract/v3/private/position/trading-stop
	/v5/position/switch-isolated	/contract/v3/private/position/switch-isolated
	/v5/position/switch-mode	/contract/v3/private/position/switch-mode
	/v5/position/set-auto-add-margin	/contract/v3/private/position/set-auto-add-margin
	/v5/position/closed-pnl	/contract/v3/position/closed-pnl
	/v5/execution/list	/unified/v3/private/execution/list
	/v5/execution/list	/contract/v3/private/execution/list
帳戶	/v5/account/wallet-balance	/unified/v3/private/account/wallet/balance
	/v5/account/wallet-balance	/contract/v3/private/account/wallet/balance
	/v5/account/upgrade-to-uta	/unified/v3/private/account/upgrade-unified-account
	/v5/account/borrow-history	/unified/v3/private/account/borrow-history
	/v5/account/collateral-info	/unified/v3/private/account/borrow-rate
	/v5/asset/coin-greeks	無
	/v5/account/info	無
	/v5/account/transaction-log	/unified/v3/private/account/transaction-log
	/v5/account/set-margin-mode	/contract/v3/private/account/setMarginMode
槓桿代幣	/v5/spot-lever-token/info	/spot/v3/public/infos
	/v5/spot-lever-token/reference	/spot/v3/private/order/reference
	/v5/spot-lever-token/purchase	/spot/v3/private/order/purchase
	/v5/spot-lever-token/redeem	/spot/v3/private/order/redeem
	/v5/spot-lever-token/order-record	/spot/v3/private/order/record
全倉槓桿	/v5/spot-margin-trade/switch-mode	/spot/v3/private/cross-margin-switch
	/v5/spot-margin-trade/set-leverage	無
	/v5/spot-margin-trade/set-pledge-token	無
資產	/v5/asset/delivery-record	/unified/v3/private/delivery-record
	/v5/asset/settlement-record	/unified/v3/private/settlement-record
	/v5/asset/transfer/inter-transfer	/asset/v3/private/transfer/inter-transfer
	v5/asset/transfer/query-inter-transfer-list	/asset/v3/private/transfer/inter-transfer/list/query
	v5/asset/transfer/save-transfer-sub-member	/asset/v3/private/transfer/transfer-sub-member-save
	/v5/asset/transfer/universal-transfer	/asset/v3/private/transfer/universal-transfer
	/v5/asset/transfer/query-universal-transfer-list	/asset/v3/private/transfer/universal-transfer/list/query
	/v5/asset/transfer/query-transfer-coin-list	/asset/v3/private/transfer/transfer-coin/list/query
	/v5/asset/transfer/query-sub-member-list	/asset/v3/private/transfer/sub-member/list/quer
	/v5/asset/transfer/query-account-coin-balance	/asset/v3/private/transfer/account-coin/balance/query
	/v5/asset/transfer/query-asset-info	/asset/v3/private/transfer/asset-info/query
	/v5/asset/deposit/query-allowed-list	/asset/v3/public/deposit/allowed-deposit-list/query
	/v5/asset/deposit/query-record	/asset/v3/private/deposit/record/query
	/v5/asset/deposit/query-sub-member-record	/asset/v3/private/deposit/sub-member-record/query
	/v5/asset/withdraw/query-record	/asset/v3/private/withdraw/record/query
	/v5/asset/coin/query-info	/asset/v3/private/coin-info/query
	/v5/asset/withdraw/create	/asset/v3/private/withdraw/create
	/v5/asset/withdraw/cancel	/asset/v3/private/withdraw/cancel
	/v5/asset/deposit/query-address	/asset/v3/private/deposit/address/query
	/v5/asset/deposit/query-sub-member-address	/asset/v3/private/deposit/sub-member-address/query
	/v5/asset/exchange/order-record	/asset/v2/private/exchange/query-exchange-order
WebSocket公共頻道	wss://stream.bybit.com/v5/public/spot	wss://stream.bybit.com/spot/public/v3
	wss://stream.bybit.com/v5/public/linear	wss://stream.bybit.com/contract/usdt/public/v3
	wss://stream.bybit.com/v5/public/linear	wss://stream.bybit.com/contract/usdc/public/v3
	wss://stream.bybit.com/v5/public/inverse	wss://stream.bybit.com/contract/inverse/public/v3
	wss://stream.bybit.com/v5/public/option	wss://stream.bybit.com/option/usdc/public/v3
WebSocket私有頻道	wss://stream.bybit.com/v5/private	wss://stream.bybit.com/spot/private/v3
		wss://stream.bybit.com/unified/private/v3
		wss://stream.bybit.com/contract/private/v3

簡介​

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

主要提升能力：​

業務線整合​

升級成本低​

提升資金利用率​

支持統一賬戶借貸：​

Paradigm大宗交易​

支持組合保證金​

接口命名規範​

API Rate Limit 規則調整​

交易延遲不變​

普通訂單和條件訂單下單合併​

增加實時訂單非活動單查詢​

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

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

增加保險基金接口​

增加更多 Websocket 數據​

提升 PostOnly 單筆下單數量​

數據精度統一規範​

Open API 文檔可讀性提升​

V5 和 V3 接口映射列表：​

簡介