切換倉位模式
該接口可以切換USDT永續和反向交割的倉位模式。單倉模式下，只能在單方向下持倉; 雙倉模式下，可以同時在兩個方向持倉。
提示
- 配置生效的優先級：symbol 配置 > coin 配置 > 系统默认配置
- 目前系統默認配置：單向持倉模式
- 如果請求參數中是按照coin的配置參數（此coin=settleCoin），則僅對該settleCoin下無持倉無委託單的symbol進行批量設置，並且未來新上線基於該settleCoin的結算的symol也是該模式。
舉例
| 系統默認 | coin | symbol | |
|---|---|---|---|
| 初始配置 | 單向持倉 | 未設置過 | 未設置過 |
| 生效結果 | 所有USDT正向交易對都是單向持倉 | ||
| 變更 1 | - | - | BTCUSDT 設置為雙向持倉模式 |
| 生效結果 | 當前交易對BTCUSDT為雙向持倉，其他交易對都是單向持倉（繼承系統默認規則） | ||
| 新上線交易對 ETHUSDT | 新上線的ETHUSDT為單向持倉 （繼承系統默認規則） | ||
| 變更 2 | - | USDT 設置為雙向持倉 | - |
| 生效結果 | 當前所有未持倉未有訂單的交易對都是雙向持倉，有持倉和有委託單的交易對不做調整 | ||
| 新上線交易對 SOLUSDT | 新上線的SOLUSDT為雙向持倉 (繼承coin規則) | ||
| 變更 3 | - | - | ASXUSDT 設置為單向持倉模式 |
| 生效結果 | AXSUSDT為單向持倉模式，其餘交易對不做任何變更（繼承coin規則） | ||
| 新上線交易對 BITUSDT | 新上線的BITUSDT為雙向持倉 (繼承coin規則) | ||
當前合約單雙向持倉切換能力
| 非統一保證金模式 | 統一保證金模式 | |
|---|---|---|
| USDT永續合約 | 支持單雙向持倉 | 僅支持單向持倉 |
| USDC永續合約 | 僅支持單向持倉 | 僅支持單向持倉 |
| 反向永續合約 | 僅支持單向持倉 | 不支持該模式下交易該合約 |
| 反向交割合約 | 支持單雙向持倉 | 不支持該模式下交易該合約 |
HTTP 請求
POST /contract/v3/private/position/switch-mode
請求參數
| 參數 | 是否必需 | 類型 | 說明 |
|---|---|---|---|
| symbol | false | string | 合約名稱. symbol 和 coin二者必傳一個. symbol優先級更高 |
| coin | false | string | 幣種名稱 |
| mode | true | integer | 倉位模式. 0: 單向持倉. 3: 雙向持倉 |
響應參數
無
請求示例
POST /contract/v3/private/position/switch-mode HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670848915553
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{
"symbol":"CHZUSDT",
"coin": null,
"mode": 0
}
響應示例
{
"retCode": 0,
"retMsg": "OK",
"result": {},
"retExtInfo": {},
"time": 1670848915768
}