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 seconds

Request

NameTypeMandatoryDescription
symListStringNTrading pair unique identifier , up to 5 sym in one query. once symList given, businessType and exchanges 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
beginStringDate of StartTime
endStringDate of EndTime
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, OKX
businessTypeStringBusinessType
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