获取子代理信息

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

描述

查询子代理信息。

HTTP请求

• GET /api/v2/broker/sub-affiliate-info

请求示例

curl "https://api.bitget.com/api/v2/broker/sub-affiliate-info" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
uid	String	否	用户ID 可传入子代理uid以查询指定子代理信息
startTime	String	否	查询开始时间 Unix毫秒时间戳
endTime	String	否	查询结束时间 Unix毫秒时间戳 开始、结束时间间隔最大30天
idLessThan	String	否	游标ID 用于翻页，获取此ID前的数据
limit	String	否	查询条数 默认100，最大100
includeDownLine	String	否	是否包含下级用户 yes 是 no 否 如不传，默认值为yes

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1758512000000,
  "data": {
    "list": [
      {
        "uid": "123456789",
        "uplineName": "agentUser001",
        "rebateRateList": [
          {
            "rebateType": "futures",
            "rebateRate": "5"
          },
          {
            "rebateType": "spot",
            "rebateRate": "5"
          }
        ],
        "verificationStatus": "verified",
        "directReferrals": "10",
        "subAffiliates": "2",
        "subAffiliateDirectReferrals": "20",
        "volume": "100000",
        "deposit": "5000",
        "transactionFee": "300",
        "rebate": "150"
      }
    ],
    "endId": "123456789"
  }
}

返回参数

返回字段	参数类型	字段说明
list	Array	子代理列表
>uid	String	用户ID
>uplineName	String	上级名称
>rebateRateList	Array	返佣比例列表
>>rebateType	String	返佣类型 futures 合约常规返佣 futures_api 合约API返佣 futures_trader 合约交易专家返佣 futures_trader_api 合约交易专家API返佣 spot 现货常规返佣 spot_api 现货API返佣 spot_trader 现货交易专家返佣 spot_trader_api 现货交易专家API返佣 onchain 链上常规返佣 onchain_api 链上API返佣 onchain_trader 链上交易专家返佣 onchain_trader_api 链上交易专家API返佣 cfd CFD常规返佣 cfd_api CFD API返佣 cfd_trader CFD交易专家返佣 cfd_trader_api CFD交易专家API返佣 stock 股票常规返佣 stock_api 股票API返佣 stock_trader 股票交易专家返佣 stock_trader_api 股票交易专家API返佣
>>rebateRate	String	返佣比例 百分比数值，如5代表5%
>verificationStatus	String	认证状态 verified 已认证 not_verified 未认证 包含KYC及KYB结果。通过KYC或KYB其中一项的用户，该字段为已认证
>directReferrals	String	直客数量
>subAffiliates	String	子代理数量
>subAffiliateDirectReferrals	String	子代理直客数量
>volume	String	交易额 单位为USDT
>deposit	String	充值金额 单位为USDT
>transactionFee	String	手续费 单位为USDT
>rebate	String	返还佣金 单位为USDT 子代理返还给渠道的佣金
endId	String	分页结尾ID 用于在发出请求时作为查询数据的索引