查询总交易统计

查询总交易统计

查询 API 用户总交易统计数据

限频：每秒 1 次

请求地址

GET /deepcoin/apiUserTradeStats/total

请求参数

字段名	是否必填	类型	字段描述
appid	是	string	AppID，用于标识第三方平台(如 FMZ、CCXT、Hummingbot)
uid	否	integer	用户ID，可选，不传则查询该 AppID 下所有用户
startTime	是	integer	起始时间，Unix 时间戳(秒)
endTime	是	integer	结束时间，Unix 时间戳(秒)
instrumentIds	否	array	标的代码列表，可选，支持多个币种查询

请求示例

{
  "appid": "FMZ",
  "uid": 12345,
  "startTime": 1700000000,
  "endTime": 1700086400,
  "instrumentIds": ["BTC-USDT-SWAP", "ETH-USDT-SWAP"]
}

响应参数

字段名	类型	字段描述
tradeAmount	number	总交易量(USDT)
netFee	number	总净手续费(USDT)
commissionFee	number	总提成金额(USDT)

响应示例

{
  "code": "0",
  "msg": "",
  "data": {
    "tradeAmount": 800000.00,
    "netFee": 400.00,
    "commissionFee": 80.00
  }
}

注意事项

• 此 API 需要特殊权限，请联系客服开通访问权限。
• 需要在请求头中使用 API Key 进行身份验证。
• 日期范围(endTime - startTime)不应超过 90 天。
• 如果不传 uid，则返回指定 appid 下所有用户的聚合数据。
• 如果不传 instrumentIds，则返回所有标的的数据。
• 数据在时间范围内按所有日期和币种进行聚合。