获取直客佣金
限速规则 10次/1s (UID)
描述
- startTime和endTime应该被同时设置或者同时不设置
- 该接口支持获取30天内数据,如需更久数据可以联系BD手动导出
- 如果请求中不设置startTime和endTime将会默认返回昨日(00:00-23:59 UTC+8)的信息
- 数据更新频率:T+1 (UTC +8)
HTTP请求
- GET /api/broker/v1/agent/customer-commissions
请求示例
curl  "https://api.bitget.com/api/broker/v1/agent/customer-commissions?uid=3125195374&startTime=1694016000000&endTime=1694332799000&idLessThan=&limit=&coin=BTC" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 | 
|---|---|---|---|
| startTime | String | 否 | 开始时间(毫秒) 开始、结束时间间隔最大30天 | 
| endTime | String | 否 | 结束时间(毫秒) 开始、结束时间间隔最大30天 | 
| idLessThan | String | 否 | 获取此ID前的数据 | 
| limit | String | 否 | 查询条数,默认100,最大1000 | 
| uid | String | 否 | 用户ID | 
| coin | String | 否 | 币种,如BTC | 
| symbol | String | 否 | 交易对 举例: BGBUSDT_SPBL spotBTCUSDT_SPBL-MABL spot marginBTCUSDT_UMCBL USDT-FuturesBTCUSD_DMCBL COIN-FuturesBTCPERP_CMCBL USDC-Futures | 
| showSub | String | 否 | 是否展示直客的下级用户信息 yes: 是no: 否 | 
返回示例
{
  "code": "00000",
  "msg": "success",
  "requestTime": 1694593273026,
  "data": {
    "endId": "6624",
    "commissionList": [
      {
        "uid": "3125195374",
        "date": "1694275200000",
        "coin": "BTC",
        "symbol": "BTCUSDT_SPBL",
        "dealAmount": "222",
        "fee": "0.0000111",
        "feeDeduction": "0.00000333",
        "activityBonusDeduct": "0.00001",
        "spotCouponDeduct": "0.00001",
        "futuresCouponDeduct": "0.00001",
        "spotFeeDiscountDeduct": "0.00001",
        "negativeMakerFeeDeduct": "0.00001",
        "feePaid": "0.00000777",
        "rebateAmount": "0.00000388",
        "userTotalRebateAmount": "0",
        "dayTotalRebateAmount": "0.00000388",
        "totalRebateAmount": "0.00000388"
      }
    ]
  }
}
返回参数
| 返回字段 | 参数类型 | 字段说明 | 
|---|---|---|
| commissionList | Array | 直客佣金列表 | 
| >uid | String | 用户ID | 
| >date | String | 返佣日期 | 
| >coin | String | 币种 | 
| >symbol | String | 交易对 | 
| >dealAmount | String | 交易量(maker+taker) | 
| >fee | String | 手续费(maker+taker) | 
| >feeDeduction | String | 手续费抵扣 | 
| >activityBonusDeduct | String | 体验金抵扣的金额 | 
| >spotCouponDeduct | String | 现货返现券抵扣的金额 | 
| >futuresCouponDeduct | String | 合约空投券抵扣的金额 | 
| >spotFeeDiscountDeduct | String | 现货手续费折扣减免的金额 | 
| >negativeMakerFeeDeduct | String | 负maker手续费抵扣的金额 | 
| >feePaid | String | 实际收取手续费(maker+taker) | 
| >rebateAmount | String | 佣金(maker+taker) | 
| >userTotalRebateAmount | String | 用户总佣金(maker+taker) | 
| >dayTotalRebateAmount | String | 当日总佣金(maker+taker) | 
| >totalRebateAmount | String | 累计总佣金(maker+taker) | 
| endId | String | 最后一条数据 ID。用于在发出请求时作为查询数据的索引 |