Query Transactions

Get transactions from the past 7 days.

Note

  • Deprecation notice: The tradingFee and tradingFeeCoin response fields are deprecated. Use fee / feeCoin instead. Both fields will be removed after 2026-11-15.
  • 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) .

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. 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.
execTypeString"MAKER" or "TAKER"
rpnlStringRealized PNL
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.
createAtStringTransactions create time
tradeSourceStringTrade source identifier. Empty string when not applicable.
Query Params
string

Order ID

string

Trading pair unique identifier , example BINANCE_SPOT_BTC_USDT, BINANCE_PERP_BTC_USDT

string

Exchange type

string

Business type

string

Query begin time

string

Query end Time

string

Limit

Response

Language
LoadingLoading…
Response
Choose an example:
application/json