Query User's Portfolio Trading Volume

GET https://api.liquiditytech.com/v1/trading/user/portfolio/tradingstats

Description

This endpoint returns portfolio-level trading volume statistics for a specified time range.

The trading volume data is updated once per day and calculated on a natural-day basis (00:00–00:00).

The response includes:

Aggregated summary fields: Trading volume (USDT-denominated) grouped by exchange and business type, such as:

• okxSpotVolUsd
• okxPerpVolUsd
• binanceSpotVolUsd
• binancePerpVolUsd

Detailed breakdown (details): A granular list grouped by exchange + businessType + symbol, including:

• executedAmount — Total executed trading volume (USDT)
• totalTradingFee — Total accumulated trading fees
• totalRpnl — Total realized PnL (Realized Profit & Loss)

Time Range Rules (Important)

The begin and end parameters must be provided as Unix timestamps in milliseconds (ms).

To ensure consistent daily aggregation:

• If begin is not at 00:00:00, it will be automatically rounded down to 00:00:00 of that day.
• If end is 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 or Sub Portfolio API key with READ permission.

Rate Limit

10 requests per 1 hour.

Request

Field	Type	Mandatory	Description
symList	String	N	Trading pair unique identifier. A maximum of 5 symbols can be specified in a single request. If symList is provided, it overrides the businessType and exchange parameters, and those filters will not take effect. Example: BINANCE_PERP_BTC_USDT, OKX_PERP_BTC_USDT
exchange	String	N	Exchange filter. Supported values: BINANCE, OKX
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	Description
begin	String	Start date/time (automatically aligned to 00:00:00 of that day)
end	String	End date/time (automatically aligned to daily boundary)
okxSpotVolUsd	String	OKX spot trading volume in USDT
okxPerpVolUsd	String	OKX perp trading volume in USDT
binanceSpotVolUsd	String	Binance spot trading volume in USDT
binancePerpVolUsd	String	Binance 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
> symbol	String	Trading pair unique identifier.
> executedAmount	String	Trading amount in USDT
> totalTradingFee	String	Total trading fee in USDT.
> totalRpnl	String	Total realized PNL in USDT.