查询返佣明细 (KEYED) - WOO X Pro

查询 login 代理子树内 referral 用户的合约返佣 settlement 明细。

请求URL

GET https://cloud-api.wooxpro.com/contract/affiliate/private/commissions

请求限制

参见速率限制详细

请求参数

请求

curl -H 'X-API-KEY:{{AccessKey}}'
'https://cloud-api.wooxpro.com/contract/affiliate/private/commissions?page=1&pageSize=20&productType=FUTURES'

参数	类型	是否必填	描述
page	Integer	必填	页码，需 > 0
pageSize	Integer	必填	每页笔数，需 > 0
uid	Long	选填	交易 cid；查无报 40053，不在 login 子树（含子树自身）报 40054
startTime	Long	选填	settlement 时间起（Unix ms）
endTime	Long	选填	settlement 时间止（Unix ms）
referralCode	String	选填	筛选经由该 referral code 邀请的用户。未知 code 返回空列表；owner 不在子树报 40055
coin	String	选填	返佣币种，自动转大写
productType	String	选填	目前仅支持 FUTURES；SPOT 报 40056；其他无效值报 40012

响应详情

响应

{
  "code": 1000,
  "trace": "0cc6f4c48b8c42538e908d3195aa109c",
  "message": "Ok",
  "data": [
    {
      "uid": "123456",
      "date": 1738820566700,
      "coin": "USDT",
      "productType": "FUTURES",
      "fee": "100",
      "netFee": "99",
      "commission": "90"
    }
  ],
  "total": 1
}

字段	类型	描述
uid	String	用户 ID（cid）
date	Long	Settlement 日期时间戳（毫秒）
coin	String	币种
productType	String	产品类型
fee	String	手续费
netFee	String	净手续费
commission	String	返佣金额
total	Long	总记录数

错误码

errMsg	code	http status
Invalid parameter!	40012	400
Trade cid not found	40053	400
Trade cid is not under your affiliate subtree	40054	403
Referral code is not under your affiliate subtree	40055	403
Spot product type is not supported	40056	400