Instrument Trade Stats

Instrument Trade Stats

Query API user trade statistics aggregated by instrument

Request frequency limit: 1/1s

Request URL

GET /deepcoin/apiUserTradeStats/instrument

Request Parameters

Field Name	Required	Type	Description
appid	true	string	AppID, used to identify third-party platforms (e.g., FMZ, CCXT, Hummingbot)
uid	false	integer	User ID, optional. If not provided, queries all users under this AppID
startTime	true	integer	Start time, Unix timestamp (seconds)
endTime	true	integer	End time, Unix timestamp (seconds)
instrumentIds	true	array	List of instrument IDs, required. Supports querying multiple instruments

Request Example

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

Response Parameters

Field Name	Type	Description
instrumentId	string	Instrument ID
tradeAmount	number	Trade volume (USDT)
netFee	number	Net fee (USDT)
commissionFee	number	Commission amount (USDT)

Response Example

{
  "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
    }
  ]
}

Notes

• This API requires special permission. Please contact support to enable access.
• Authentication is required using API Key in the request header.
• The date range (endTime - startTime) should not exceed 90 days.
• If uid is not provided, the API returns aggregated data for all users under the specified appid.
• instrumentIds is required and must contain at least one instrument ID.
• Data is aggregated by instrument across the entire time range.