Query Transactions (Pageable)

Get transactions from the past 7 days.

Permission

  • Applies to both primary user and trading portfolio's API Key.
  • Permission: READ.

Rate Limit

  • 20 requests per 1 seconds

Request

NameTypeMandatoryDescription
orderIdStringNOrder ID. If provided, the query will return executions related to this order.
symStringNTrading pair unique identifier ,
example BINANCE_SPOT_BTC_USDT, BINANCE_PERP_BTC_USDT
exchangeStringNExchange type, such as BINANCE, OKX
businessTypeStringNBusiness type of the trade, for example SPOT, PERP
beginStringNStart time of the query window. If not specified, the default is to query data from up to 7 days ago.
endStringNEnd time of the query window. If not specified, the current time is used.
pageStringNCurrent page number (starting from 1).
pageSizeStringNPage size. Default is 1000, maximum 1000.

Response

FieldTypeRemark
transactionIdStringUnique identifier of this trade execution record. One order may generate multiple executions.
portfolioIdStringIdentifier of the portfolio or sub-account to which this trade belongs.
orderIdStringSystem-generated order ID associated with this execution.
exchangeStringExchange type, such as BINANCE, OKX
businessTypeStringBusiness type of the trade, for example SPOT, PERP
symStringTrading pair unique identifier
sideStringTrade side, such as BUY or SELL (or other venue-specific side values).
quantityStringExecuted quantity for this trade.
priceStringExecuted price for this trade.
tradingFeeStringTrading fee charged for this execution.
tradingFeeCoinStringCurrency in which the trading fee is charged (e.g. USDT, BTC).
rpnlStringRealized PnL generated by this execution.
clientOrderIdStringClient-defined order ID passed when placing the order (used for idempotency and client-side tracking).
algoOrderIdStringID of the parent algo order if this execution was generated by an algorithmic strategy; 0 or empty if not applicable.
createAtStringTimestamp when this trade execution was created, in milliseconds since Unix epoch.
execTypeStringLiquidity role of this execution: "MAKER" or "TAKER".

Note

This endpoint provides the same 7-day execution history, but with cursor-based pagination.

Use this version when you expect a large number of fills and need to scroll through the full history reliably without hitting response size limits.

Language