升級到UTA PRO

升級引導

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

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

信息

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

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

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

2. 當從統一帳戶2.0升級到統一帳戶2.0 Pro時, 確保沒有任何掛單
   
   
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: xxxxxxxxxxxxxxxxxx
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="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.upgrade_to_unified_trading_account())

GO

import (
    "context"
    "fmt"
    bybit "github.com/bybit-exchange/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: 'xxxxxxxxxxxxxxxxxx',
    secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

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
}