Get Order Details

Description

Get previous futures order.

• There is no time limit for placing orders.
• For historical orders, if they are cancellations, only those within 5 hours will be retained; for other types, those within 90 days will be supported.
• If there are multiple orders with the same clOrdId, the information of the most recent order will be matched.

HTTP Request

GET /v3/trade/order/details

Request Parameters

Parameter	Required	Type	Description
ordId	No	String	Order ID, Either ordId or clOrdId must be passed. If both are passed, both will be verified.
clOrdId	No	String	Client Order ID as assigned by the client

Response Parameters

Parameter	Type	Description
symbol	String	A trading pair, consisting of two currencies: base currency and quote currency
side	String	Enumerate: BUY and SELL
type	String	Order type; enumerate MARKET, LIMIT, and LIMIT_MAKER
ordId	String	Order ID
clOrdId	String	Client Order ID as assigned by the client
mgnMode	String	Margin Mode, Enumerate: ISOLATED, CROSS
posSide	String	Position side LONG SHORT BOTH
px	String	Price
sz	String	Order size, specifically in Cont
state	String	Order Status: Enumerate FILLED, PARTIALLY_CANCELED, CANCELED
cancelReason	String	USER_CANCEL_ORDER_ACTION, LIMIT_MAKER_ORDER_INCORRECT_PRICE_CONDITION, LIMIT_MATCH_IOC_OR_FOK_ORDER_PRICE_CANNOT_MATCH, LIMIT_MATCH_FOK_ORDER_MAKER_INSUFFICIENT_AVAILABLE_QUANTITY, LIMIT_MATCH_IOC_ORDER_CANNOT_FILLED, LIMIT_MATCH_ORDER_TAKER_SELF_TRADE,MARKET_ORDER_NO_OTHER_SIDE_ORDER, INVALID_PARAM_WHEN_PLACE_ORDER, INVALID_ORDER_TYPE_WHEN_PLACE_ORDER, INVALID_SEQUENCE_PLACE_ORDER_AFTER_CANCEL_SAME_ORDER, MATCH_SYMBOL_TRADE_LIMIT_NOT_EXIST, EXCEED_SLIPPAGE_TOLERANCE, OUT_OF_RANGE_LIMIT_PRICE,NO_MARGIN_QUANTITY_GREAT_THAN_POSITION, LIMIT_MATCH_ORDER_ONLY_SELF_TRADE, FL_CANCEL_ORDER_ACTION, RISK_CANCEL_ORDER_ACTION, SYS_CANCEL_ORDER_ACTION
source	String	Order Source: Enumerate WEB, APP, API, SMART, WEB_MARGIN, APP_IOS, APP_ANDROID, APP_IOS_MARGIN, APP_ANDROID_MARGIN, API_MARGIN, SMART_MARGIN, WS, WS_MARGIN, GRID, GRID_MARGIN, SYSTEM, COPY_TRADING, TRIGGER, LIQUIDATION, ADL, TRIAL, MARGIN_FL, MARGIN_FL_OFFLINE
reduceOnly	Boolean	Reduce only
timeInForce	String	Enumerate FOK, IOC, and GTC. It is an optional field with GTC by default.
avgPx	String	Average execution price
execQty	String	Cumulative execution amount
execAmt	String	Cumulative execution value
feeCcy	String	Name of the currency used for trading fees
feeAmt	String	Cumulative amount of trading fee
deductCcy	String	Name of the currency used to deduct trading fees
deductAmt	String	Cumulative amount of trading fee deducted
actType	String	Account type
qCcy	String	Quote currency
stpMode	String	Enumerate - EXPIRE_TAKER - EXPIRE_MAKER - EXPIRE_BOTH Default is NONE
cTime	String	Order creation time with a UTC timestamp (MS)
uTime	String	Order update time with a UTC timestamp (MS)

Request Example

{
  "ordId": "550983022728966144", 
  "clOrdId": "polo550983022728966144"
}

Response Example

{
    "code": 200,
    "msg": "Success",
    "data": {
        "symbol": "ETH_USDT_PERP",
        "side": "SELL",
        "type": "LIMIT_MAKER",
        "ordId": "550983022728966144",
        "clOrdId": "polo550983022728966144",
        "mgnMode": "CROSS",
        "px": "4280",
        "reduceOnly": false,
        "lever": "10",
        "state": "NEW",
        "source": "WEB",
        "timeInForce": "GTC",
        "tpTrgPx": "",
        "tpPx": "",
        "tpTrgPxType": "",
        "slTrgPx": "",
        "slPx": "",
        "slTrgPxType": "",
        "avgPx": "0",
        "execQty": "0",
        "execAmt": "0",
        "feeCcy": "",
        "feeAmt": "0",
        "deductCcy": "0",
        "deductAmt": "0",
        "stpMode": "NONE",
        "cTime": "1772330989388",
        "uTime": "1772421110038",
        "sz": "2",
        "posSide": "SHORT",
        "qCcy": "USDT"
    }
}