Query Transactions

Get transactions from the past 7 days.

Permission

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

Rate Limit

  • 5 requests per 10 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(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.
limitStringNMaximum number of records to return. Default is 1000, maximum is 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.
clientOrderIdStringClient-defined order ID passed when placing the order (used for idempotency and client-side tracking).
exchangeTypeStringExchangeType(BINANCE、OKX)
businessTypeStringBusiness type of the trade, such as 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 returns normalized trade execution records for the last up to 7 days within the specified time range.

The result is not paginated – the server returns up to the maximum number of records allowed by the limit parameter in a single response.

Language