Order History

Time	Status	User Agent
Retrieving recent requests…

Rate Limit: 30 requests per 10 seconds

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

It retrieves a list of orders 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	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/history/orders?sym=BINANCE_SPOT_ETH_USDT&begin=1744380000000&end=1744466400000&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": "1744380600000",
        "updateAt": "1744380615000",
        "cancelType": "",
        "amendType": "",
        "algoOrderId": ""
      }
    ]
  }
}

Request

Response

Example Request

Example Response

200200