Get Sub-Account List

Info

• This endpoint requires signature. For specific signature rules, please refer to Authentication
• This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.

Reminder

• This endpoint can only be accessed using the ACCESS ID of the main account

HTTP request

GET /account/subs

Request parameters

Parameter Name	Required	Type	Notes
sub_user_name	false	string	Sub-account username
is_frozen	false	bool	Frozen or not.Default is false
page	false	int	Number of pagination. Default is 1
limit	false	int	Number in each page. Default is 10

Return parameters

Parameter Name	Type	Notes
sub_user_name	string	Sub-account username
is_frozen	bool	Whether the sub-account is frozen or not.
is_authorized	bool	Whether it is authorized or not.
permissions	[]string	Sub-account permission list
balance_usd	string	Market value of sub-account balance

---

Request example

GET /account/subs?is_frozen=false&page=1&limit=10

Response example

{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "sub_user_name": "sub2", 
            "is_frozen": true, 
            "is_authorized": false, 
            "permissions": ["FUTURES", "API"], 
            "balance_usd": "3564.23"
        }
    ],
    "pagination": {
        "total": 1,
        "has_next": false
    }
}