> ## 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.

# Commissions (KEYED)

`Query contract commission settlement records for referral users within the login agent's subtree.`

#### Request URL

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

#### Request Limit

See [Detailed Rate Limit](/english/rate-limit)

#### Request Parameter

> Request

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

| Field        | Type    | Required? | Description                                                                                                             |
| :----------- | :------ | :-------- | :---------------------------------------------------------------------------------------------------------------------- |
| page         | Integer | Yes       | Page number, must be > 0                                                                                                |
| pageSize     | Integer | Yes       | Records per page, must be > 0                                                                                           |
| uid          | Long    | No        | Trading cid; returns 40053 if not found, 40054 if not in login subtree (subtree includes self)                          |
| startTime    | Long    | No        | Settlement start time (Unix ms)                                                                                         |
| endTime      | Long    | No        | Settlement end time (Unix ms)                                                                                           |
| referralCode | String  | No        | Filter users invited via this referral code. Unknown codes return empty list; if owner is not in subtree, returns 40055 |
| coin         | String  | No        | Commission currency; auto-converts to uppercase                                                                         |
| productType  | String  | No        | Currently only supports FUTURES; SPOT returns 40056; other invalid values return 40012                                  |

#### Response Data

> Response

```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
}
```

| Field       | Type   | Description                    |
| :---------- | :----- | :----------------------------- |
| uid         | String | User ID (cid)                  |
| date        | Long   | Settlement date timestamp (ms) |
| coin        | String | Currency                       |
| productType | String | Product type                   |
| fee         | String | Fee                            |
| netFee      | String | Net fee                        |
| commission  | String | Commission amount              |
| total       | Long   | Total number of records        |

#### Error Codes

| 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     |