跳到主要内容

获取直属邀请用户资产

API说明​

此接口用于查询当前代理商直属邀请用户的账户入金金额、出金金额及当前账户余额。

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

注意事项​

  1. 请求参数 startTime 和 endTime 必须使用 yyyy-MM-dd HH:mm:ss 格式，系统会在下游请求时转换为毫秒时间戳。
  2. 不传 startTime 和 endTime 时，默认返回用户从账户创建以来的累计账户入金和出金数额。
  3. 结果按 uid 升序排序。
  4. pageSize 默认值为 10，最大值为 1000。
  5. 账户当前余额返回数据不受 startTime 和 endTime 影响，直接返回当前账户的余额。

认证​

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

请求方法​

GET

接口地址​

/api/v3/patener/openapi/v1/partner/invitation/user/assets

频率限制​

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

请求参数​

参数必填类型描述
uidfalseLong被邀请用户的 UID。不传则查询当前代理商名下所有邀请用户。
startTimefalseString查询开始时间，格式 yyyy-MM-dd HH:mm:ss。
endTimefalseString查询结束时间，格式 yyyy-MM-dd HH:mm:ss。
quotefalseString结算币种。可选值：usdt、usdc。当传入 usdc 时返回 USDC 资产；不传时默认返回 USDT 资产。
pageNofalseInteger当前页码，默认 1。
pageSizefalseInteger每页数量，默认 20，最大 100。

响应参数​

参数类型描述
codeString返回状态码
msgString返回信息
dataObject返回数据
data.totalInteger总记录数
data.listArray直属邀请用户资产列表
data.list[].uidLong被邀请用户 UID
data.list[].totalDepositString用户入金金额
data.list[].totalWithdrawalString用户出金金额
data.list[].currentBalanceString用户当前账户余额
data.list[].updateTimeString用户账户上次余额更新时间

请求示例​

params = {
    "uid": 12345678,
    "quote": "usdt",
    "pageNo": 1,
    "pageSize": 20
}

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

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

响应示例​

{
  "code": "0",
  "msg": "success",
  "data": {
    "total": 2,
    "list": [
      {
        "uid": 12345678,
        "totalDeposit": "15000.00000000",
        "totalWithdrawal": "3000.00000000",
        "currentBalance": "5800.00000000",
        "updateTime": "2026-05-21 10:25:00"
      },
      {
        "uid": 87654321,
        "totalDeposit": "8200.00000000",
        "totalWithdrawal": "1200.00000000",
        "currentBalance": "4300.50000000",
        "updateTime": "2026-05-21 10:25:00"
      }
    ]
  }
}