Time	Status	User Agent
Retrieving recent requests…

Order History Archive

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

Rate Limit: 30 requests per 10 seconds

This endpoint returns archived order history for the specified portfolio covering the period from 7 days up to 90 days in the past.

Note: This endpoint queries a large dataset and may respond slowly. Set your client timeout to at least 30 seconds.

It includes spot, margin and derivatives orders with the same schema as the recent order history API, allowing clients to query, reconcile and audit older order activity beyond the last 7 days.

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 90 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	Internal order type assigned by the system. `DMA` for standard direct-market-access orders. Also 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	Cumulative trading fee for this order. Positive = fee charged (taker). `"0"` when the order earned a maker rebate instead (see `rebate` field).
`feeCoin`	String	Currency of the trading fee. Empty string if no fee was charged.
`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.
`borrowAmount`	String	Borrowed amount for margin trading (if applicable).
`borrowAsset`	String	Asset symbol of the borrowed currency.
`positionSide`	String	Position side. In One-Way Mode, this is always `NONE`. In Hedge Mode, `LONG` and `SHORT` indicate 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	Reason the order was cancelled. Possible values: `USER`, `EXPIRE`, `REDUCE_ONLY`, `LIQUIDATING`, `SYSTEM`, `SYM_DELIST`. Empty string if the order was not cancelled.
`amendType`	String	Reason the order was amended. Possible values: `USER`, `REDUCE_ONLY`. Empty string if the order was not amended.
`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.

Example Request

GET /api/v1/trading/archive/history/orders?sym=BINANCE_SPOT_ETH_USDT&begin=1741788000000&end=1742392800000&page=1&pageSize=10

Example Response

{
  "code": 200000,
  "message": "Success",
  "data": {
    "page": 1,
    "pageSize": 10,
    "pageNum": 1,
    "totalSize": 1,
    "list": [
      {
        "portfolioId": "1732260294043000",
        "portfolioName": "Main Portfolio",
        "orderId": "2106591138643265",
        "clientOrderId": "myorder001",
        "orderState": "FILLED",
        "sym": "BINANCE_SPOT_ETH_USDT",
        "side": "BUY",
        "exchangeOrderType": "LIMIT",
        "exchangeType": "BINANCE",
        "orderType": "DMA",
        "businessType": "SPOT",
        "orderQty": "0.5",
        "quoteOrderQty": "",
        "limitPrice": "3100",
        "timeInForce": "GTC",
        "reason": "",
        "executedQty": "0.5",
        "executedAvgPrice": "3100",
        "executedAmount": "1550",
        "reduceOnly": false,
        "lastExecutedQty": "0.5",
        "lastExecutedPrice": "3100",
        "lastExecutedAmount": "1550",
        "leverage": 1,
        "fee": "1.55",
        "feeCoin": "USDT",
        "rebate": "0",
        "rebateCoin": "",
        "borrowAmount": "0",
        "borrowAsset": "",
        "positionSide": "NONE",
        "tpTriggerPrice": "",
        "tpTriggerType": "LAST_PRICE",
        "tpPrice": "0",
        "slTriggerPrice": "",
        "slTriggerType": "LAST_PRICE",
        "slPrice": "0",
        "createAt": "1741788600000",
        "updateAt": "1741788615000",
        "cancelType": "",
        "amendType": "",
        "algoOrderId": ""
      }
    ]
  }
}

Order History Archive

Request

Response

Example Request

Example Response

200200