get
https://api.liquiditytech.com/api/v1/trading/user/tradingStats
Description
This endpoint returns user-level trading volume statistics for a specified time range.
The returned trading volume is aggregated across the entire user portfolios, including:
- Main Portfolio
- All Sub Portfolios
The trading volume data is updated once per day and calculated on a natural-day basis (00:00–00:00).
Time Range Rules (Important)
The begin and end parameters must be provided as Unix timestamps in milliseconds (ms).
To ensure consistent daily aggregation:
- If
beginis not at 00:00:00, it will be automatically rounded down to 00:00:00 of that day. - If
endis not at 00:00:00, it will be automatically aligned to the daily boundary (natural-day cutoff at 00:00:00).
The response fields begin and end are returned in yyyyMMdd format and reflect the aligned date range used for calculation.
Permission
- Access to this endpoint requires a Main Portfolio API key with READ permission.
- API keys created under Sub Portfolios are not eligible to query this endpoint at this time.
Rate Limit
20 requests per 1 second.
Request
| Field | Type | Mandatory | Description |
|---|---|---|---|
exchange | String | N | Exchange filter. Supported values: BINANCE, OKX, EDX |
businessType | String | N | Business type filter. Supported values: SPOT, PERP |
begin | String | Y | Start date/time (automatically aligned to 00:00:00 of that day) |
end | String | Y | End date/time (automatically aligned to daily boundary) |
Response
| Field | Type | Remark |
|---|---|---|
begin | String | Start date/time (automatically aligned to 00:00:00 of that day) |
end | String | End date/time (automatically aligned to daily boundary) |
allSpot | String | Total spot trading volume in USDT |
allPerp | String | Total perp trading volume in USDT |
details | Object | List of trading amount detail |
exchange | String | BINANCE, OKX, EDX |
businessType | String | SPOT, PERP. MARGIN Trading Volume is included in the SPOT Volume |
executedAmount | String | Trading amount in USDT |
