Query Portfolio Trading Stats

Query the trading statistics of a portfolio

Notes: transactions within today has not been included.

Permission

  • Primary API Key: READ, retrieve trading stats on sym level of the main portfolio
  • Sub-Portfolio API Key: READ, retrieve trading stats on sym level of the current portfolio

Rate Limit

  • 20 requests per 1 second

Request

NameTypeMandatoryDescription
symListStringNTrading 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
businessTypeStringNbusinessType: SPOT / PERP
exchangeStringNOKX / BINANCE
beginStringYStart time, in milliseconds timestamp format (utc 0:00), up to 90 days period, able to support 1 year ago. Will be converted to 0am of the Date
endStringYEnd time, in milliseconds timestamp format (utc 0:00), up to 90 days period,Will be converted to 0am of the Date

Response

FieldTypeRemark
beginStringStart date/time (automatically aligned to 00:00:00 of that day)
endStringEnd date/time (automatically aligned to daily boundary)
okxSpotVolUsdStringOKX-Total spot trading amount(USDT Volume)
okxPerpVolUsdStringOKX-Total perp trading amount(USDT Volume)
binanceSpotVolUsdStringBinance-Total spot trading amount(USDT Volume)
binancePerpVolUsdStringBinance-Total spot trading amount(USDT Volume)
detailsObjectList of trading amount detail
exchangeStringexchange: BINANCE, OKXEDX
businessTypeStringSPOT, PERP. MARGIN Trading volume is included in the SPOT Volume
executedAmountStringTrading amount(USDT Volume)
symbolStringTrading pair unique identifier
totalTradingFeeStringTotal trading fee paid (converted to USDT)
totalRpnlStringTotal realized PNL (converted to USDT)

Note:

the parameters begin and end only extract the year, month, and day from the timestamp.
For example: If the timestamp for begin corresponds to 2025-12-23 10:30:00(UTC), and the timestamp for end corresponds to 2025-12-24 08:00:00(UTC),
then the final statistics will cover the data for the two days: 2025-12-23 to 2025-12-24.

Language