查询下级交易统计
HTTP request 获取一个或多个直客在指定时间范围内的交易量与返佣数据。
- GET
/api/v3/agency/getDealData
权重(IP): 20, 权重(UID): 20
请求参数
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| userIds | List<Long> | 否 | 可重复传递的查询参数,默认查询全部直客 |
| startTime | String | 否 | 开始日期(UTC,格式 yyyy-MM-dd) |
| endTime | String | 否 | 结束日期(UTC,格式 yyyy-MM-dd) |
请求示例
curl "https://api-spot.weex.com/api/v3/agency/getDealData?userIds=4667776811&startTime=2025-02-01&endTime=2025-03-01" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*******" \
-H "ACCESS-PASSPHRASE:*****" \
-H "ACCESS-TIMESTAMP:1732972800000" \
-H "Content-Type: application/json"
返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| data | Array | 上游返回的交易统计数据列表 |
| userId | Long | 直客 UID |
| spotDealAmountUsdt | String | 现货交易量(USDT) |
| futuresProDealAmountUsdt | String | 合约交易量(USDT) |
| spotProDealAmountUsdtTemp | String | 现货交易量原始值 |
| startTime | String | 本次查询使用的开始日期(yyyy-MM-dd) |
| endTime | String | 本次查询使用的结束日期(yyyy-MM-dd) |
返回示例
{
"data": [
{
"futuresProDealAmountUsdt": "619659.79380470",
"spotDealAmountUsdt": "75156.60000000",
"spotProDealAmountUsdtTemp": "75156.6",
"userId": 4667776811
}
],
"endTime": "2026-03-04",
"startTime": "2025-12-03"
}