get
https://api.liquiditytech.com/api/v1/trading/archive/executions/pageable
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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 historical execution records from 7 to 90 days ago. Use this endpoint for backfilling, reconciliation, and reporting that requires data beyond the recent 7-day window.
Authentication required. Permission: READ.
Rate limit: 5 requests per 10 seconds.
Request Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
orderId | String | N | Order ID. If provided, the query will return executions related to this order. |
sym | String | N | Trading pair unique identifier. For example: BINANCE_SPOT_BTC_USDT, BINANCE_PERP_BTC_USDT. |
exchange | String | N | Exchange type, such as BINANCE, OKX, EDX. |
businessType | String | N | Business type of the trade, for example SPOT, PERP, MARGIN. |
begin | String | N | Start time of the query window. If not specified, the default is to query data from up to 7 days ago. |
end | String | N | End time of the query window. If not specified, the current time is used. |
page | String | N | Page number to retrieve. Default is 1. |
pageSize | String | N | Number of records per page. Default is 1000, maximum is 1000. |
Response Fields
Pagination Envelope
| Field | Type | Description |
|---|---|---|
page | Integer | Current page number returned by this response. |
pageSize | Integer | Number of records included per page. |
pageNum | Integer | Total number of pages available for the current query. |
totalSize | Integer | Total number of matching execution records across all pages. |
list | Array | Array of execution records. Each element has the fields below. |
List Item Fields
| Field | Type | Description |
|---|---|---|
transactionId | String | Unique identifier of this trade execution record. One order may generate multiple executions. |
portfolioId | String | Identifier of the portfolio or sub-account to which this trade belongs. |
orderId | String | System-generated order ID associated with this execution. |
exchangeType | String | Venue where the trade was executed (e.g. BINANCE, OKX, EDX). |
businessType | String | Business type of the trade, such as SPOT, PERP, MARGIN. |
sym | String | Internal unique identifier of the trading pair or instrument. |
side | String | Trade side, such as BUY or SELL (or other venue-specific side values). |
quantity | String | Executed quantity for this trade. |
price | String | Executed price for this trade. |
tradingFee | String | Trading fee charged for this execution. Deprecated — use fee instead. Will be removed after 2026-11-15. |
tradingFeeCoin | String | Currency in which the trading fee is charged (e.g. USDT, BTC). Deprecated — use feeCoin instead. Will be removed after 2026-11-15. |
fee | String | Trading fee charged for this execution. |
feeCoin | String | Currency in which the trading fee is charged (e.g. USDT, BTC). |
rebate | String | Cumulative 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. |
rebateCoin | String | Currency of the rebate. Empty string if no rebate was received. |
rpnl | String | Realized PnL generated by this execution. |
clientOrderId | String | Client-defined order ID passed when placing the order (used for idempotency and client-side tracking). |
algoOrderId | String | ID of the parent algo order if this execution was generated by an algorithmic strategy; 0 or empty if not applicable. |
createAt | String | Timestamp when this trade execution was created, in milliseconds since Unix epoch. |
execType | String | Liquidity role of this execution: "MAKER" or "TAKER". |
tradeSource | String | Trade source identifier. Empty string when not applicable. |