升級統一保證金賬戶

升級統一保證金賬戶

升級引導

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

• 如果unifiedMarginStatus=1, 則表示當前帳戶是經典帳戶, 您可以調用以下接口升級到UTA Pro. 等到調用升級接口後一段時間, 重新調用查詢賬戶配置接口, 如果unifiedMarginStatus=4, 則表示帳戶已經成功升級至UTA Pro.

• 如果unifiedMarginStatus=3, 則表示當前帳戶是統一交易帳戶 (UTA), 您可以調用以下接口升級到UTA Pro. 等到調用升級接口後一段時間, 重新調用查詢賬戶配置接口, 如果unifiedMarginStatus=4, 則表示帳戶已經成功升級至UTA Pro.

important

封禁 / 極簡鏈路用戶當前無法升級至統一帳戶.

信息

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

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

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

2. 為保證順利升級，請確保：

• 當前現貨帳戶內無任何掛單或負債
• 在合約帳戶內無任何掛單，並且確保所有USDT永續倉位要麼逐倉要麼全倉
• 在USDC合約帳戶無任何掛單
• 注意，倉位附帶的止盈止損單也屬於掛單

3. 帳戶升級實時返回的unifiedUpgradeProcess為PROCESS時，代表需要系統異步校驗處理，無法實時返回升級結果，您可在3-5分鐘後通過查詢API Key相關信息 接口，根據返回中的"uta"字段確認是否升級成功

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

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())

響應示例

{
    "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
}