获取直客列表

限速规则 10次/1s (UID)

描述

• startTime和endTime应该被同时设置或者同时不设置
• startTime和endTime支持的最大时间跨度为30天
• 该接口只支持获取30天内注册用户列表,如需更久注册列表,可以联系 BD进行手动导出
• 如果请求中不设置startTime和endTime将会默认返回昨日(00:00-23:59 UTC+8)注册的用户 信息
• 如果想确认某UID是否是您邀请的直客,可以通过在body里传入UID进行验证,例如{"uid':"123456"}
• 注册直客数据更新信息是实时的

HTTP请求

• POST /api/broker/v1/agent/customerList

请求示例

curl -X POST "https://api.bitget.com/api/broker/v1/agent/customerList" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{"pageNo": "1","pageSize": "500","startTime": "1734540617923","endTime": "1735094086646"}'

请求参数

参数名	参数类型	是否必须	描述
startTime	String	否	开始时间(毫秒)
endTime	String	否	结束时间(毫秒)
pageNo	String	否	页码
pageSize	String	否	分页大小,默认100,最大1000
uid	String	否	UID
referralCode	String	否	邀请code
showSub	String	否	是否展示直客的下级用户信息 yes: 是 no: 否

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695785738672,
  "data": [
    {
      "uid": 1235665663,
      "registerTime": "1679991960110"
    },
    {
      "uid": 1235665663,
      "registerTime": "1679991960110"
    }
  ]
}

返回参数

返回字段	参数类型	字段说明
uid	String	UID
registerTime	String	注册时间