Query Order Detail

Time	Status	User Agent
Retrieving recent requests…

Rate Limit: 1200 requests per 60 seconds

Permission: RapidX API key with read-only permission is sufficient. No trading / write permission is required.

Retrieves the detailed information and current status of a specific order. This includes execution details, order parameters, fee information, and algorithmic order settings (Take-Profit/Stop-Loss).

Request

Field	Type	Mandatory	Description
`orderId`	String	N	Unique identifier of the order assigned by the system.
`clientOrderId`	String	N	Customer-defined order ID, consists of letters (a-z) and numbers (0-9).

At least one of the following parameters (orderId or clientOrderId) must be provided to identify the order.

Response

Field	Type	Description
`portfolioId`	String	Unique identifier for the portfolio.
`portfolioName`	String	Name of the portfolio (if applicable).
`orderId`	String	Unique identifier for the order.
`clientOrderId`	String	User-defined order ID.
`orderState`	String	See ENUM Definitions for supported values.
`sym`	String	Internal unique identifier for the trading pair.
`side`	String	Order side: `BUY` or `SELL`.
`exchangeOrderType`	String	Order type defined by the exchange (e.g., `LIMIT`, `MARKET`).
`exchangeType`	String	The exchange name (e.g., `BINANCE`, `OKX`).
`businessType`	String	Type of market (e.g., `SPOT`, `MARGIN`, `PERP`).
`orderType`	String	Internal order type assigned by the system. `DMA` for standard direct-market-access orders. Also see ENUM Definitions for supported values.
`orderQty`	String	Order quantity. Note: Units are in contracts for OKX and in coins (base currency) for Binance.
`quoteOrderQty`	String	Total quantity in quote currency (if applicable).
`limitPrice`	String	Order limit price.
`timeInForce`	String	Time in force policy (e.g., `GTC`, `IOC`, `FOK`).
`executedQty`	String	Total executed quantity. For spot orders, this is the filled amount of the base asset. 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).
`executedAmount`	String	Total executed quote amount.
`executedAvgPrice`	String	Average price of executed fills.
`lastExecutedQty`	String	Quantity of the most recent execution.
`lastExecutedPrice`	String	Price of the most recent execution.
`lastExecutedAmount`	String	Value of the most recent execution.
`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.
`reduceOnly`	Boolean	Whether the order is reduce-only: `true` or `false`.
`leverage`	Integer	Leverage used for the order.
`borrowAmount`	String	Amount borrowed for margin/leverage.
`borrowAsset`	String	Asset borrowed for the order.
`positionSide`	String	Position side (e.g., `LONG`, `SHORT`, `NONE`).
`algoOrderId`	String	ID of the parent algorithmic order (if applicable).
`tpTriggerPrice`	String	Trigger price for Take-Profit.
`tpTriggerType`	String	Take-profit trigger price type: `LAST_PRICE` (Default), `MARK_PRICE`.
`tpPrice`	String	Execution price for Take-Profit. If the price is 0, take-profit will be executed at the market price.
`slTriggerPrice`	String	Trigger price for Stop-Loss.
`slTriggerType`	String	Stop-loss trigger price type: `LAST_PRICE` (Default), `MARK_PRICE`.
`slPrice`	String	Execution price for Stop-Loss. If the price is 0, stop-loss will be executed at the market price.
`reason`	String	Failure reason message, if the order is rejected or cancelled by the system.
`action`	String	Current in-flight action on the order, if any. `AMEND_PENDING` — amendment submitted, awaiting confirmation. `AMEND_COMPLETED` — amendment confirmed. `AMEND_FAILED` — amendment rejected. `CANCEL_PENDING` — cancel submitted, awaiting confirmation. `CANCEL_COMPLETE` — cancellation confirmed. `CANCEL_FAILED` — cancellation rejected. Empty string when no action is in progress.
`actionMsg`	String	Additional message associated with the current action, if any.
`cancelType`	String	Reason the order was cancelled. Possible values: `USER`, `EXPIRE`, `REDUCE_ONLY`, `LIQUIDATING`, `SYSTEM`, `SYM_DELIST`. Empty string if the order has not been cancelled.
`amendType`	String	Reason the order was amended. Possible values: `USER`, `REDUCE_ONLY`. Empty string if the order has not been amended.
`createAt`	String	Order creation timestamp (millisecond).
`updateAt`	String	Last update timestamp (millisecond).

Example Request

GET /api/v1/trading/order?orderId=2106591138643265

Example Response

{
  "code": 200000,
  "message": "Success",
  "data": {
    "portfolioId": "1732260294043000",
    "portfolioName": "Main Portfolio",
    "orderId": "2106591138643265",
    "clientOrderId": "myorder001",
    "orderState": "FILLED",
    "sym": "BINANCE_SPOT_ETH_USDT",
    "side": "SELL",
    "exchangeOrderType": "LIMIT",
    "exchangeType": "BINANCE",
    "orderType": "DMA",
    "businessType": "SPOT",
    "orderQty": "0.5",
    "quoteOrderQty": "",
    "limitPrice": "3200",
    "timeInForce": "GTC",
    "executedQty": "0.5",
    "executedAmount": "1600",
    "executedAvgPrice": "3200",
    "lastExecutedQty": "0.5",
    "lastExecutedPrice": "3200",
    "lastExecutedAmount": "1600",
    "fee": "1.6",
    "feeCoin": "USDT",
    "rebate": "0",
    "rebateCoin": "",
    "reduceOnly": false,
    "leverage": 1,
    "borrowAmount": "0",
    "borrowAsset": "",
    "positionSide": "NONE",
    "algoOrderId": "",
    "tpTriggerPrice": "",
    "tpTriggerType": "LAST_PRICE",
    "tpPrice": "0",
    "slTriggerPrice": "",
    "slTriggerType": "LAST_PRICE",
    "slPrice": "0",
    "reason": "",
    "action": "",
    "actionMsg": "",
    "cancelType": "",
    "amendType": "",
    "createAt": "1744466400000",
    "updateAt": "1744466410000"
  }
}

Request

Response

Example Request

Example Response

200200