Skip to main content

Total Trade Stats

Total Trade Stats

Query API user total trade statistics

Request frequency limit: 1/1s

Request URL

GET /deepcoin/apiUserTradeStats/total

Request Parameters

Field NameRequiredTypeDescription
appidtruestringAppID, used to identify third-party platforms (e.g., FMZ, CCXT, Hummingbot)
uidfalseintegerUser ID, optional. If not provided, queries all users under this AppID
startTimetrueintegerStart time, Unix timestamp (seconds)
endTimetrueintegerEnd time, Unix timestamp (seconds)
instrumentIdsfalsearrayList of instrument IDs, optional. Supports querying multiple instruments

Request Example

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

Response Parameters

Field NameTypeDescription
tradeAmountnumberTotal trade volume (USDT)
netFeenumberTotal net fee (USDT)
commissionFeenumberTotal commission amount (USDT)

Response Example

{
"code": "0",
"msg": "",
"data": {
"tradeAmount": 800000.00,
"netFee": 400.00,
"commissionFee": 80.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.
  • If instrumentIds is not provided, the API returns data for all instruments.
  • Data is aggregated across all dates and instruments within the time range.