Order History

GET https://api.liquiditytech.com/api/v1/trading/history/orders

Rate Limit: 30 requests per 10 seconds

This endpoint returns the order history of the specified portfolio for the last 7 days.

This endpoint retrieves a list of orders for the specified portfolio, including spot, margin and derivatives orders. It returns key order information such as symbol, side, order type, quantity, execution status, filled quantity/price, fees, and TP/SL settings, allowing clients to reconstruct the full lifecycle of each order for monitoring, reconciliation, and reporting.

Request

Name	Type	Mandatory	Description
sym	String	N	Trading pair unique identifier. For example: BINANCE_SPOT_BTC_USDT, BINANCE_PERP_BTC_USDT.
businessType	String	N	Business type of the trade, for example SPOT, PERP, MARGIN.
exchange	String	N	Exchange type, such as BINANCE, OKX, EDX.
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.
filterExecuted	Boolean	N	Whether to return only executed orders. Default false – return all orders regardless of execution status.
page	String	N	Current page number (starting from 1).
pageSize	String	N	Page size. Default is 1000, maximum 1000.

Response

Field	Type	Description
portfolioId	String	Identifier of the portfolio or sub-account this order belongs to.
portfolioName	String	Portfolio name.
orderId	String	System-generated order ID associated with this order.
clientOrderId	String	Customer-defined order ID.
orderState	String	See ENUM Definitions for supported values.
sym	String	Trading pair unique identifier. Example: BINANCE_SPOT_ETH_USDT, OKX_PERP_ETH_USDT, EDX_PERP_ETH_USDT.
side	String	Order side: BUY or SELL.
exchangeOrderType	String	Exchange order type, e.g. LIMIT, MARKET.
exchangeType	String	Venue where the order is placed, e.g. BINANCE, OKX, EDX.
orderType	String	See ENUM Definitions for supported values.
businessType	String	Business type of the order, e.g. SPOT, PERP, MARGIN.
orderQty	String	Order quantity. For spot orders, this is the amount of the base asset (e.g. ETH in ETH/USDT). For derivatives, on OKX this is the number of contracts, and on Binance USDT-margined contracts it is effectively the base asset quantity (1 contract = 1 unit of the base asset).
quoteOrderQty	String	Order quote quantity, in units of the quote asset of the trading pair. Primarily used for market buy orders in spot and margin trading (e.g. amount of USDT or BTC to spend). For other order types it may be ignored by the venue.
limitPrice	String	Order price.
timeInForce	String	Time in force. Default GTC. Supported values: GTC, IOC, FOK, GTX.
reason	String	Failure reason message, if the order is rejected or cancelled by the system.
executedQty	String	Total executed quantity. For spot orders, this is the filled amount of the base asset (e.g. ETH in ETH/USDT). For derivatives, on OKX this is the number of contracts, and on Binance USDT-margined contracts it is effectively the base asset quantity (1 contract = 1 unit of the base asset).
executedAvgPrice	String	Average execution price of the filled quantity.
executedAmount	String	Total executed quote amount.
reduceOnly	Boolean	Reduce-only flag. true means the order can only reduce existing positions; false otherwise.
lastExecutedQty	String	Quantity of the most recent fill, in the same unit as executedQty.
lastExecutedPrice	String	Price of the most recent fill.
lastExecutedAmount	String	Quote amount of the most recent fill.
leverage	Integer	Leverage applied to this order or position.
fee	String	Trading fee amount charged for this order.
feeCoin	String	Currency in which the trading fee is charged.
rebate	String	Rebate amount received for this order (if any).
rebateCoin	String	Currency in which the rebate is paid.
borrowAmount	String	Borrowed amount for margin trading (if applicable).
borrowAsset	String	Asset symbol of the borrowed currency.
positionSide	String	Position side, depending on the position mode. In One-Way Mode, this is always NONE (no separate long/short leg, net position only). In Hedge Mode, LONG and SHORT indicate that the order belongs to the long or short leg of the position.
tpTriggerPrice	String	Take-profit trigger price.
tpTriggerType	String	Reference price type for the take-profit trigger. Supported values: LAST_PRICE, MARK_PRICE. Default is LAST_PRICE.
tpPrice	String	Take-profit order price. If set to 0, the take-profit order will execute at market price.
slTriggerPrice	String	Stop-loss trigger price.
slTriggerType	String	Reference price type for the stop-loss trigger. Supported values: LAST_PRICE, MARK_PRICE. Default is LAST_PRICE.
slPrice	String	Stop-loss order price. If set to 0, the stop-loss order will execute at market price.
createAt	String	Order creation time, in milliseconds since Unix epoch.
updateAt	String	Last update time of the order, in milliseconds since Unix epoch.
cancelType	String	Order cancel type. Possible values: USER, EXPIRE, REDUCE_ONLY, LIQUIDATING, SYSTEM, SYM_DELIST.
amendType	String	Order amend type. Possible values: USER, REDUCE_ONLY.
algoOrderId	String	Algo / strategy order ID on the venue, if the order is generated by an algorithmic or strategy order. Empty or null for normal orders.