試點功能
升級反向合約帳戶
- 可用日期: 測試網 - 已上線, 主網 - 2024年9月13日 (批次開放)
- 覆蓋範圍: 統一帳戶
- 詳細內容: 1. 選擇升級反向合約帳戶到統一帳戶; 2. 參考帳戶模式介紹
Open API支持模擬交易
- 可用日期: 測試網 - 已上線, 主網 - 2024年4月3日
- 覆蓋範圍: 模擬交易賬戶
- 詳細內容: 您可以參閱該頁面進行體驗
websocket下改撤單功能
- 可用日期: 測試網 - 已上線, 主網 - 待定
- 覆蓋範圍: 統一帳戶現貨/正向合約/期權交易
- 詳細內容: 您可以使用websocket來下改撤單
批量接口支持現貨交易
- 可用日期: 測試網 - 已上線, 主網 - 2024年3月5日
- 覆蓋範圍: 統一帳戶現貨交易
- 詳細內容: 您可以使用批量下改撤接口進行現貨交易
現貨支持雙向止盈止損
- 可用日期: 測試網 - 已上線, 主網 - 2024年1月15日
- 覆蓋範圍: 統一帳戶現貨交易
- 詳細內容: 您可以在創建現貨訂單時通過takeProfit, stopLoss設置市價止盈止損
現貨支持組合保證金對衝
- 可用日期: 測試網 - 已上線, 主網 - 2023年11月16日
- 覆蓋範圍: 統一帳戶的組合保證金模式
- 詳細內容: 您可以通過這個設置現貨對衝接口啟用或關閉現貨對衝功能
現貨支持改單
- 可用日期: 測試網 - 已上線, 主網 - 2023年11月1日
- 覆蓋範圍: 經典帳戶和統一帳戶現貨
- 詳細內容: 您可以通過這個改單接口對現貨訂單進行改單
統一帳戶現貨止盈止損單、條件單邏輯修改
- 可用日期: 測試網 - 已上線, 主網 - 2023年10月26日 (按照uid尾號灰度期間, 全量預計11月2日)
- 覆蓋範圍: 統一帳戶的現貨交易
- 詳細內容: 當止盈止損單或者條件單觸發後, 訂單ID保持不變
UTA Pro支持批量下單
- 可用日期: 測試網 - 已上線, 主網 - 2023年8月31日
- 覆蓋範圍: UTA Pro帳戶: USDT永續, USDC永續 & USDC交割 (正向合約linear)
- 詳細內容: UTA Pro帳戶能夠進行正向合約的批量下改撤
示例
- 批量下單
- 批量改單
- 批量撤單
POST https://api-testnet.bybit.com/v5/order/create-batch
> 請求體
{
"category": "linear",
"request": [
{
"symbol": "BTCUSDT",
"orderType": "Limit",
"side": "Buy",
"qty": "0.1",
"price": "25500",
"timeInForce": "GTC",
"orderLinkId": "test-03",
"reduceOnly": false,
"tpslMode": "Full",
"takeProfit": "26300",
"stopLoss": "24800",
"triggerDirection": null,
"triggerPrice": null,
"triggerBy": null,
"positioIdx": 0,
"smpType": null,
"tpLimitPrice": null,
"slLimitPrice": null,
"slOrderType": null,
"tpOrderType": null
},
{
"symbol": "ETHUSDT",
"orderType": "Limit",
"side": "Buy",
"qty": "0.1",
"price": "1550",
"timeInForce": "GTC",
"orderLinkId": "test-04",
"reduceOnly": false,
"tpslMode": "Full",
"takeProfit": "1680",
"stopLoss": "1490",
"triggerDirection": null,
"triggerPrice": null,
"triggerBy": null,
"positioIdx": 0,
"smpType": null,
"tpLimitPrice": null,
"slLimitPrice": null,
"slOrderType": null,
"tpOrderType": null
}
]
}
> 響應
{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"category": "linear",
"symbol": "BTCUSDT",
"orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14",
"orderLinkId": "test-03",
"createAt": "1693212677410"
},
{
"category": "linear",
"symbol": "ETHUSDT",
"orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c",
"orderLinkId": "test-04",
"createAt": "1693212677410"
}
]
},
"retExtInfo": {
"list": [
{
"code": 0,
"msg": "OK"
},
{
"code": 0,
"msg": "OK"
}
]
},
"time": 1693212677411
}
POST https://api-testnet.bybit.com/v5/order/amend-batch
> Request Body
{
"category": "linear",
"request": [
{
"symbol": "BTCUSDT",
"orderType": "Limit",
"qty": "0.05",
"price": "25800",
"orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14"
},
{
"symbol": "ETHUSDT",
"orderType": "Limit",
"qty": "0.05",
"price": "1495",
"orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c"
}
]
}
> Response
{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"category": "linear",
"symbol": "BTCUSDT",
"orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14",
"orderLinkId": "test-03"
},
{
"category": "linear",
"symbol": "ETHUSDT",
"orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c",
"orderLinkId": "test-04"
}
]
},
"retExtInfo": {
"list": [
{
"code": 0,
"msg": "OK"
},
{
"code": 0,
"msg": "OK"
}
]
},
"time": 1693212802143
}
POST https://api-testnet.bybit.com/v5/order/cancel-batch
> Request Body
{
"category": "linear",
"request": [
{
"symbol": "BTCUSDT",
"orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14"
},
{
"symbol": "ETHUSDT",
"orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c"
}
]
}
> Response
{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"category": "linear",
"symbol": "BTCUSDT",
"orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14",
"orderLinkId": "test-03"
},
{
"category": "linear",
"symbol": "ETHUSDT",
"orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c",
"orderLinkId": "test-04"
}
]
},
"retExtInfo": {
"list": [
{
"code": 0,
"msg": "OK"
},
{
"code": 0,
"msg": "OK"
}
]
},
"time": 1693212965773
}
增加WS私有連接可配置斷線時間
- 可用日期: 測試網 - 已上線, 主網 - 2023年8月16日
- 覆蓋範圍: 構建v5私有連接時可用該配置參數
- 詳細內容: 構建連接時, 設置
/v5/private?max_active_time=
, 值可以是從30s
到600s
之間。當服務端與客戶端之間無上下行數據時, 當達到這個配置的時間間隔時, 服務端則會斷開連接 (並不完全準確, 因為當前ticker的輪訓時間是30秒)
調整錯誤碼
- 可用日期: 測試網 - 已上線, 主網 - 2023年8月14日
- 覆蓋範圍: 全倉槓桿開關, 全倉槓桿設置, 設置保證金模式, 設置保證金模式,設置保證金模式
- 詳細內容: 當機構借貸用戶處於強平時, 相關接口調用返回的錯誤碼發生改變
舊錯誤碼 | 新錯誤碼 | 消息 |
---|---|---|
3200320 | Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated. | |
3200320 | Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated. |
UTA母子帳戶間共享借貸額度
- 可用日期: 測試網 - 已上線, 主網 - 2023年8月11日
- 覆蓋範圍: 統一帳戶
- 詳細內容: 過去, 每個uta帳戶擁有獨自的借貸額度, 上線後, 該額度由母子之間共享
UTA用戶可以選擇保證金幣種是否進行抵押
- 可用日期: 測試網 - 已上線, 主網 - 2023年8月10日
- 覆蓋範圍: 統一帳戶
- 詳細內容: UTA用戶可以選擇保證金幣種是否進行抵押通過該接口
用戶可以自主升級到UTA Pro
- 可用日期: 測試網 - 已上線, 主網 - 2023年8月8日
- 覆蓋範圍: 普通帳戶, 統一帳戶
- 詳細內容: 用戶可以通過該接口升級至UTA Pro
OpenAPI支持現貨條件單
- 可用日期: 測試網 - 已上線, 主網 - 2023年8月7日
- 覆蓋範圍: 普通帳戶, 統一帳戶
- 詳細內容: 用戶可以通過openAPI創建現貨條件單
UTA支持機構借貸
- 可用日期: 測試網 - 已上線, 主網 - 2023年7月24日
- 覆蓋範圍: 統一帳戶
- 詳細內容: 統一帳戶支持機構借貸
USDC永續支持獲得資金費的數據
- 可用日期: 測試網 - 已上線, 主網 - 2023年7月3日
- 覆蓋範圍: 統一帳戶 USDC永續合約
- 詳細內容: 查詢成交紀錄接口之前是沒有
execType=Funding
的且websocket個人成交不推送該數據. 現在您將會查詢到和獲得推送.
新版帶單交易
- 可用日期: 測試網 - 已上線, 主網 - 2023年6月24日
- 覆蓋範圍: 舊版帶單交易
- 詳細內容: Bybit將會從6月24日開始陸續開放uid升級功能, 如果您選擇升級到新的帶單交易, 請注意老版本的Copy Trading V3接口將不可再用, 請直接使用合約 V3 或者 V5接口
統一帳戶支持逐倉保證金模式和雙倉模式
- 可用日期: 測試網 - 已上線, 主網 - 2023年6月1日
- 覆蓋範圍: 僅統一帳戶生效
- 詳細內容: 統一帳戶的逐倉保證金是帳戶維度. 雙向持倉僅支持USDT永續
新版止盈止損
- 可用日期: 測試網 - 已上線, 主網 - 2023年5月23日
- 覆蓋範圍: V5 API 和 合約V3 API
- 詳細內容: 統一帳戶(UTA): USDT 永續, USDC 永續 和 交割, 反向合約
普通帳戶: USDT 永續, 反向合約
查詢升級前紀錄
- 可用日期: 測試網 - 已上線, 主網 - 2023年4月27日
- 覆蓋範圍: 統一交易帳戶
- 詳細內容: 升級後,可以通過該接口查詢到升級之前的一些交易紀錄.
余幣寶 (廢棄)
- 可用日期: 測試網 - 已上線, 主網 - 2023年4月22日
- 覆蓋範圍: 所有用戶 (目前灰度階段)
- 詳細內容: 您可以將閒置資金存入余幣寶來賺取收益
自成交攔截
- 可用日期: 測試網 - 已上線, 主網 - 2023年4月20日
- 覆蓋範圍: 請查看這裡
- 詳細內容: 支持現貨、期貨和期權
支持持倉升級至UTA帳戶
- 可用日期: 測試網 - 已上線, 主網 - 2023年4月4日
- 覆蓋範圍: 普通帳戶升級至統一帳戶
- 詳細內容: 升級時無需平倉. 更多細節,請查閱升級接口
統一交易帳戶支持USDC交割產品交易
- 可用日期: 測試網 - 已上線, 主網 - 2023年3月20日
- 覆蓋範圍: 僅限升級到UTA的帳戶
- 詳細內容: V5接口將適用於UTA帳戶交易USDC交割
機構借貸V5接口
- 可用日期: 測試網 - 已上線, 主網 - 2023年3月13日
- 覆蓋範圍: 申請了場外借貸的機構用戶
- 詳細內容: 可以查詢到帳戶的LTV, 借款及還款等信息
普通帳戶支持使用V5接口進行現貨交易
- 可用日期: 測試網 - 已上線, 主網 - 2023年3月10日
- 覆蓋範圍: 普通帳戶
- 詳細內容: 使用V5交易現貨
統一交易對狀態枚舉
- 可用日期: 測試網 - 已上線, 主網 - 2023年3月10日
- 覆蓋範圍: /v5/market/instruments-info
status
字段 - 詳細內容: 統一使用
Trading
,Closed
,Settling
,PreLaunch
,Deliverying
上線全倉槓桿(普通帳戶)V5版本
- 可用日期: 測試網 - 已上線, 主網 - 2023年3月3日
- 覆蓋範圍: 普通帳戶能夠使用V5接口操作全倉槓桿
- 詳細內容: 借貸、還款、查詢操作
UTA用戶支持交易反向合約
- 可用日期: 測試網 - 已上線, 主網 - 2023年2月21日
- 覆蓋範圍: UTA用戶能夠通過V5接口交易反向合約
- 詳細內容: 請注意該反向合約交易是通過反向合約錢包(CONTRACT)完成
將現貨帳戶併入統一帳戶(重要)
- 可用日期: 預計3月3日当天執行
- 覆蓋範圍: 僅UTA用戶
- 詳細內容: 您需要修改提現邏輯,先將資金轉入資金帳戶,然後調用提現接口
使用RSA密鑰方式鑒權
- 可用日期: 測試網 - 已上線, 主網 - 2023年2月21日
- 覆蓋範圍: 所有V3、V5需要鑒權的接口
- 詳細內容: 請參閱該引導完成快速上手
execType
增加新的枚舉值
- 可用日期: 測試網 - 已上線, 主網 - 2023年2月20日
- 覆蓋範圍: 合約 V3 - Websocket私有頻道 - 個人成交
- 詳細內容: 新增資金費用結算的推送,其中execType=
Funding
V5接口支持普通帳戶
- 可用日期: 測試網 - 已上線, 主網 - 2023年2月9日
- 覆蓋範圍: 普通帳戶支持交易 USDT永續 and 反向合約
- 詳細內容: 此次發佈之後,如果您有以下行為,您可能會遭遇一些401錯誤或者404錯誤:
401: 您仍然在使用v1/v2的鑒權方式訪問V5接口:
GET https://api.bybit.com/v5/position/list?api_key=xxx&category=linear&recv_window=5000&symbol=ETHUSDT×tamp=1675929695887&sign=xxx
您應該將鑒權參數放在請求頭當中:
Host: api-testnet.bybit.com
-H 'X-BAPI-SIGN: XXXXXXXXXX' \
-H 'X-BAPI-API-KEY: XXXXXXXXXX' \
-H 'X-BAPI-TIMESTAMP: 1658384431891' \
-H 'X-BAPI-RECV-WINDOW: 5000'
404: 對於以下接口,如果您傳入不恰當的category值, 比如, 您是普通帳戶,但category傳入了option/spot
調整錯誤碼
- 可用日期: 測試網 - 已上線, 主網 - 2023年1月19日
- 覆蓋範圍: V5 設置保證金模式, V3-Unified 設置保證金模式 和 V1-USDC 設置保證金模式
- 詳細內容:
舊錯誤碼 | 新錯誤碼 | 消息 |
---|---|---|
110073 | Set margin mode failed | |
10016 | Server error |