查詢子帳戶UID列表 (無限制)

通過翻頁獲取當前母帳戶下所有的子帳戶列表，適合超過擁有1萬個子帳戶的母帳戶進行調用。需使用母帳戶的API key。

提示

在調用接口時，使用的API key至少需要擁有以下其中一種權限

• 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

HTTP 請求

GET /v5/user/submembers

請求參數

參數	是否必須	類型	說明
pageSize	false	string	數據頁大小. 每次至多返回100條
nextCursor	false	string	游標. 傳入響應中的nextCursor來獲取下一頁的數據

返回參數

參數	類型	說明
subMembers	array	Object
> uid	string	子帳戶userId
> username	string	用戶名
> memberType	integer	1: 普通子帳戶, 6: 託管子帳戶
> status	integer	帳戶狀態. 1: 正常 2: 登陸封禁 4: 凍結
> accountMode	integer	帳戶模式. 1: 經典帳戶 3: UTA帳戶 4: UTA1.0 Pro 帳戶 5: UTA2.0 帳戶 6: UTA2.0 Pro 帳戶
> remark	string	備註
nextCursor	string	下一頁數據的游標. 返回"0"表示沒有更多的數據了

請求示例

HTTP

GET /v5/user/submembers?pageSize=1 HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1676430318405
X-BAPI-RECV-WINDOW: 5000

Python

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "subMembers": [
            {
                "uid": "106314365",
                "username": "xxxx02",
                "memberType": 1,
                "status": 1,
                "remark": "",
                "accountMode": 5
            },
            {
                "uid": "106279879",
                "username": "xxxx01",
                "memberType": 1,
                "status": 1,
                "remark": "",
                "accountMode": 6
            }
        ],
        "nextCursor": "0"
    },
    "retExtInfo": {},
    "time": 1760388041006
}