跳至主要内容

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

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

提示

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

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

HTTP 請求

GET /v5/user/submembers

請求參數

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

返回參數

參數類型說明
subMembersarrayObject
> uidstring子帳戶userId
> usernamestring用戶名
> memberTypeinteger1: 普通子帳戶, 6: 託管子帳戶
> statusinteger帳戶狀態.
  • 1: 正常
  • 2: 登陸封禁
  • 4: 凍結
> accountModeinteger帳戶模式.
  • 1: 經典帳戶
  • 3: UTA帳戶
> remarkstring備註
nextCursorstring下一頁數據的游標. 返回"0"表示沒有更多的數據了

請求示例

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

響應示例

{
"retCode": 0,
"retMsg": "",
"result": {
"subMembers": [
{
"uid": "100475023",
"username": "BybitmcYERjAPmMU",
"memberType": 1,
"status": 1,
"remark": "",
"accountMode": 1
}
],
"nextCursor": "126671"
},
"retExtInfo": {},
"time": 1711695552772
}