升級統一保證金賬戶

升級引導

通過調用查詢賬戶配置接口來確認當前的帳戶型態

• 如果是經典帳戶, unifiedMarginStatus=1, 可以直接調用該接口升級到統一帳戶2.0 Pro, 調用查詢賬戶配置接口, 如果unifiedMarginStatus=6, 則表示帳戶已經成功升級至統一帳戶2.0 Pro.

• 如果unifiedMarginStatus=3, 則表示帳戶是統一帳戶1.0, 您需要前往網站或者app端先升級到統一帳戶2.0

• 如果unifiedMarginStatus=4, 則表示帳戶是統一帳戶1.0 Pro, 您可以調用升級接口升級到統一帳戶2.0 Pro. 調用查詢賬戶配置接口, 如果unifiedMarginStatus=6, 則表示帳戶已經成功升級至統一帳戶2.0 Pro.

• 如果unifiedMarginStatus=5, 則表示帳戶是統一帳戶2.0, 您可以調用升級接口升級到統一帳戶2.0 Pro. 調用查詢賬戶配置接口, 如果unifiedMarginStatus=6, 則表示帳戶已經成功升級至統一帳戶2.0 Pro.

important

封禁用戶無法升級至統一帳戶.

信息

您現在可以持倉完成升級了，但請注意以下事項：

1. 升級請避開以下時段:

每個小時	當前時間在小時整點的前10分鐘及後5分鐘內

2. 當從統一帳戶2.0升級到統一帳戶2.0 Pro時, 確保沒有任何掛單
   
   關於升級統一帳戶1.0 Pro到統一帳戶2.0 Pro的條件, 請確保:

• 對於任意一種訂單類型, 都沒有活動單
• 所有的反向合約倉位的保證金模式必須和您統一帳戶的保證金模式保持一致. 如果統一帳戶保證金模式是組合保證金, 則要麽將反向倉為全部平掉, 要麽切換統一帳戶保證金模式到逐倉或者全倉
• 不能有雙向的反向交割倉位, 因為統一帳戶2.0中不支持雙向反向交割
• 注意，倉位附帶的止盈止損單也屬於掛單

3. 帳戶升級過程中，可能會由於帳戶相關資產數據處於處理狀態中導致查詢/推送的數據不準確，建議在完成升級後，再查詢和使用。

HTTP 請求

POST /v5/account/upgrade-to-uta

請求參數

無

響應參數

Parameter	Type	Comments
unifiedUpdateStatus	string	用戶賬戶的升級狀態. PROCESS: 處理中, FAIL: 失敗, SUCCESS: 成功
unifiedUpdateMsg	Object	若是PROCESS,SUCCESS，則返回null
msg	array	錯誤原因列表. 只有FAIL時，才會有msg這個字段

---

請求示例

HTTP

POST /v5/account/upgrade-to-uta HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672125123533
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.upgrade_to_unified_trading_account())

GO

import (
    "context"
    "fmt"
    bybit "github.com/wuhewuhe/bybit.go.api"
)
client := bybit.NewBybitHttpClient("YOUR_API_KEY", "YOUR_API_SECRET")
client.NewUtaBybitServiceNoParams().UpgradeToUTA(context.Background())

Java

import com.bybit.api.client.config.BybitApiConfig;
import com.bybit.api.client.domain.account.request.AccountDataRequest;
import com.bybit.api.client.domain.account.AccountType;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newAccountRestClient();
System.out.println(client.upgradeAccountToUTA());

.Net

using bybit.net.api;
using bybit.net.api.ApiServiceImp;
using bybit.net.api.Models;
BybitAccountService accountService = new(apiKey: "xxxxxx", apiSecret: "xxxxx");
Console.WriteLine(await accountService.UpgradeAccount());

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
    key: 'apikey',
    secret: 'apisecret',
});

client
    .upgradeToUnifiedAccount()
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "unifiedUpdateStatus": "FAIL",
        "unifiedUpdateMsg": {
            "msg": [
                "Update account failed. You have outstanding liabilities in your Spot account.",
                "Update account failed. Please close the usdc perpetual positions in USDC Account.",
                "unable to upgrade, please cancel the usdt perpetual open orders in USDT account.",
                "unable to upgrade, please close the usdt perpetual positions in USDT account."
            ]
        }
    },
    "retExtInfo": {},
    "time": 1672125124195
}