Get Order by External ID

Response Example

{
  "success": true,
  "code": 0,
  "data": {
    "orderId": "739106551624717312",
    "symbol": "BTC_USDT",
    "positionId": 1109973831,
    "price": 109777.5,
    "priceStr": "109777.500000000000000000",
    "vol": 5,
    "leverage": 2,
    "side": 1,
    "category": 1,
    "orderType": 5,
    "dealAvgPrice": 109777.5,
    "dealAvgPriceStr": "109777.500000000000000000",
    "dealVol": 5,
    "orderMargin": 27.444375,
    "takerFee": 0,
    "makerFee": 0,
    "profit": 0,
    "feeCurrency": "USDT",
    "openType": 1,
    "state": 3,
    "externalOid": "_m_903a9f81cc1148be99ac9ece15981374",
    "errorCode": 0,
    "usedMargin": 27.444375,
    "createTime": 1761887134000,
    "updateTime": 1761887134000,
    "positionMode": 1,
    "version": 2,
    "showCancelReason": 0,
    "showProfitRateShare": 0,
    "bboTypeNum": 0,
    "totalFee": 0,
    "zeroSaveTotalFeeBinance": 0,
    "zeroTradeTotalFeeBinance": 0
  }
}

• GET /api/v1/private/order/external/{symbol}/{external_oid}

Required Permission: View Order Details

Rate limit: 20 times/2 seconds

Request Parameters:

Parameter	Type	Required	Description
symbol	string	true	Contract
external_oid	string	true	External order ID

Response Parameters:

Parameter	Type	Description
orderId	long	Order id
symbol	string	Contract
positionId	long	Position id
price	decimal	Order price
vol	decimal	Order quantity
leverage	long	Leverage
side	int	Order side 1 open long,2 close short,3 open short,4 close long
category	int	Order category:1 limit,2 liquidation custody,3 custody close,4 ADL reduction
dealAvgPrice	decimal	Average deal price
dealVol	decimal	Deal quantity
orderMargin	decimal	Order margin
takerFee	decimal	Taker fee
makerFee	decimal	Maker fee
profit	decimal	Close PnL
feeCurrency	string	Fee currency
openType	int	Open type,1 isolated,2 cross
state	int	Order status,1: pending,2 unfilled,3 filled,4 canceled,5 invalid
externalOid	string	External order ID
createTime	date	Created time
updateTime	date	Updated time