Get Agent Customer List

• Rate limit: 10/sec/UID

Description

• startTime and endTime should be both set or both left blank
• startTime and endTime should be within 30days
• This API endpoint can only query the data in 30 days. If you need older data, please contact BD to export manually
• It will return yesterday's data (00:00-23:59 UTC+8) by default if there is no startTime/endTime set.
• If you want to confirm whether a specific UID is your referral client you invited, you can verify it by setting the UID in the body, for example: {"uid":"123456"}.
• The data is updated in real time

HTTP Request

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

Request Example

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"}'

Request Parameters

Parameter	Type	Required	Description
startTime	String	No	Start time (ms)
endTime	String	No	End time (ms)
pageNo	String	No	Page number
pageSize	String	No	Page size, 100 default, Max 1000
uid	String	No	UID
referralCode	String	No	Referral code

Response Example

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

Response Parameters

Parameter	Type	Description
uid	String	UID
registerTime	String	Register time