跳至主要内容

創建基金子賬戶

信息
  1. 子賬戶創建為異步操作。第一次調用時,status 返回 pendingsubAccountUid 返回 "0"。後台創建完成後,使用相同參數再次調用該接口,將返回 "status": "Active",新建子賬戶的 UID 會顯示在 subAccountUid 字段中。也可以通過 查詢機構管轄的基金列表 查看基金下關聯的子賬戶列表,以確認子賬戶是否創建成功。
  2. 基金必須為 Active(運行中) 狀態才能創建子賬戶。
  3. 每個基金最多支持 30 個子賬戶(不包括已銷毀的)。
  4. 如果當前有處於 pending 狀態的子賬戶正在創建,則不允許創建新的子賬戶,需等待當前創建完成後再操作。

HTTP 請求

POST/v5/earn/pwm/asset-manager/create-sub-account

請求參數

參數是否必需類型說明
fundIdtruestring基金ID
reqLinkIdtruestring用戶自定義請求ID,用於防止重複調用創建

響應參數

參數類型說明
fundIdstring基金ID
subAccountUidstring新創建的子賬戶UID。創建中時返回 "0",創建成功後使用同一個 reqLinkId 請求將返回實際的非零UID
createdTimestring創建時間戳(毫秒)
statusstring創建狀態:pending(創建中)/ success(創建成功)/ destroyed(已銷毀)

請求示例

POST /v5/earn/pwm/asset-manager/create-sub-account HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741651200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"fundId": "100001",
"reqLinkId": "create-sub-001"
}

響應示例

{
"retCode": 0,
"retMsg": "success",
"result": {
"fundId": "100001",
"subAccountUid": "0",
"createdTime": "1700600000000",
"status": "pending"
}
}