> ## Documentation Index
> Fetch the complete documentation index at: https://developer.wooxpro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询返佣明细 (KEYED)

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

#### 请求URL

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

#### 请求限制

参见 [速率限制详细](/cn/rate-limit)

#### 请求参数

> 请求

```shell theme={null}
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                   |

#### 响应详情

> 响应

```json theme={null}
{
  "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     |