跳到主要内容

按币种查询交易统计

按币种查询交易统计​

查询 API 用户按币种聚合的交易统计数据

限频：每秒 1 次

请求地址​

GET /deepcoin/apiUserTradeStats/instrument

请求参数​

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

请求示例​

{
  "appid": "FMZ",
  "uid": 12345,
  "startTime": 1700000000,
  "endTime": 1700086400,
  "instrumentIds": ["BTCUSDT", "ETHUSDT"]
}

响应参数​

字段名类型字段描述
instrumentIdstring标的代码
tradeAmountnumber交易量(USDT)
netFeenumber净手续费(USDT)
commissionFeenumber提成金额(USDT)

响应示例​

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "instrumentId": "BTCUSDT",
      "tradeAmount": 500000.00,
      "netFee": 250.00,
      "commissionFee": 50.00
    },
    {
      "instrumentId": "ETHUSDT",
      "tradeAmount": 300000.00,
      "netFee": 150.00,
      "commissionFee": 30.00
    }
  ]
}

注意事项​

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