Query Transactions

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Deprecation notice: The tradingFee and tradingFeeCoin response fields are deprecated. Use fee / feeCoin instead. Both fields will be removed after 2026-11-15.

Description

Retrieve trade execution records from the last 7 days. Returns up to 1000 records in a single response without pagination. For paginated access, use Query Transactions (Pageable) .

Authentication required. Permission: READ.

Rate limit: 5 requests per 10 seconds.

Request Parameters

NameTypeMandatoryDescription
orderIdStringNOrder ID. If provided, the query will return executions related to this order.
symStringNTrading pair unique identifier. For example: BINANCE_SPOT_BTC_USDT, BINANCE_PERP_BTC_USDT.
exchangeStringNExchange type, such as BINANCE, OKX, EDX.
businessTypeStringNBusiness type of the trade, for example SPOT, PERP, MARGIN.
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 Fields

FieldTypeDescription
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.
exchangeTypeStringVenue where the trade was executed (e.g. BINANCE, OKX, EDX).
businessTypeStringBusiness type of the trade, such as SPOT, PERP, MARGIN.
symStringInternal unique identifier of the trading pair or instrument.
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. Deprecated — use fee instead. Will be removed after 2026-11-15.
tradingFeeCoinStringCurrency in which the trading fee is charged (e.g. USDT, BTC). Deprecated — use feeCoin instead. Will be removed after 2026-11-15.
feeStringTrading fee charged for this execution.
feeCoinStringCurrency in which the trading fee is charged (e.g. USDT, BTC).
rebateStringCumulative maker rebate received. 0 for taker orders. For OKX spot: BUY orders return quote currency, SELL orders return base currency. For Binance spot: returns quote currency. For perpetuals: returns USDT.
rebateCoinStringCurrency of the rebate. Empty string if no rebate was received.
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".
tradeSourceStringTrade source identifier. Empty string when not applicable.
Query Params
string
string
string
string
string
string
string
Response

Language
LoadingLoading…
Response
Choose an example:
application/json