Get Virtual Subaccounts

Frequency limit: 10 times/1s (User ID)

Description

Get a list of virtual sub-account

HTTP Request

• GET /api/v2/user/virtual-subaccount-list

Request Example

curl "https://api.bitget.com/api/v2/user/virtual-subaccount-list?limit=20" \
  -H "ACCESS-KEY:*******" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

Request Parameters

Parameter	Type	Required	Description
limit	String	No	Entries per page Default: 100, maximum: 500
idLessThan	String	No	Final sub-account ID, required for paging.
status	String	No	Sub-account status normal Normal freeze Freeze

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1656589586807,
    "data": {
        "endId": 51,
        "subAccountList": [
            {
                "subAccountUid": "********",
                "subAccountName": "****@*****.com",
                "status": "normal",
                "permList": [
                    "read",
                    "spot_trade",
                    "contract_trade"
                ],
                "label": "mySub01",
                "accountType":"hosting",
                "bindingTime":"1653287983475",
                "cTime": "1653287983475",
                "uTime": "1682660169573"
            }
        ]
    }
}

Response Parameters

Parameter	Type	Description
subAccountList	Array	Sub-account array
> subAccountUid	String	Sub-account uid
> subAccountName	String	Sub-account username
> label	String	Sub-account ApiKey note, max length 20
> status	String	Sub-account status normal Normal freeze Freeze del Deleted
> permList	List	Sub-account permissions spot_trade Spot trade contract_trade Futures trade read-write read Read permissions
> cTime	String	Sub-account creation time
> uTime	String	Sub-account update time
endId	String	This is used when idLessThan/idGreaterThan is set as a range.