跳到主要内容

获取邀请用户 KYC 结果

API说明​

此接口用于获取当前已认证 Affiliate 用户直属邀请用户的 KYC 认证结果。

仅包含直属邀请用户，不包含下级 Affiliate 用户邀请的用户。

若邀请用户的 KYC 等级为 1，则返回结果为 passed；否则返回 not_passed。

该接口最多支持查询近 6 个月的 KYC 记录。

注意事项​

  1. 请求参数 startTime 和 endTime 必须使用 yyyy-MM-dd HH:mm:ss 格式。
  2. 对于 GET 请求，所有请求参数必须通过 URL Query 传递，不应放在请求体中。
  3. 未传 startTime 时，默认取当月开始时间。
  4. 未传 endTime 时，默认取当月结束时间。
  5. 结果按 register_time 倒序排序，再按 id 排序以保证稳定性。
  6. pageSize 默认值为 100，最大值为 1000。

认证​

这是一个私有接口，需要认证。有关 RESTful API 的使用方式，请参考 简介 > 认证和签名。

请求方法​

GET

接口地址​

/api/v3/patener/openapi/v1/partner/invitation/user/kyc/list

频率限制​

该接口的调用频率限制为：每个 IP 和用户 ID 每秒最多请求5次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅"频率限制"部分，跳转

请求参数​

参数必填类型描述
startTimefalseString开始时间，格式 yyyy-MM-dd HH:mm:ss，按注册时间过滤。未传时默认当月开始时间。
endTimefalseString结束时间，格式 yyyy-MM-dd HH:mm:ss，按注册时间过滤。未传时默认当月结束时间。
pageNofalseInteger页码，默认 1。
pageSizefalseInteger每页条数，默认 100，最大 1000。
uidfalseLong按指定邀请用户 UID 过滤。

响应参数​

参数类型描述
data.list[].uidLong邀请用户 UID
data.list[].kycResultStringKYC 结果：passed 或 not_passed
data.totalLong总记录数

请求示例​

params = {
    "pageNo": 1,
    "pageSize": 100,
    "startTime": "2026-03-01 00:00:00",
    "endTime": "2026-03-31 23:59:59"
}

api_url = "/api/v3/patener/openapi/v1/partner/invitation/user/kyc/list"

method = "GET"
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key)  # 函数 FuturesRestfulPrivate() 定义在章节（简介 > 认证和代码示例 > 合约 > RESTful 私有接口）

响应示例​

{
  "code": "200",
  "msg": "success",
  "data": {
    "list": [
      {
        "uid": 1116977,
        "kycResult": "passed"
      }
    ],
    "total": 1
  }
}