Skip to main content

Batch Query Orders by External Order ID

Response Example

{
"success": true,
"code": 0,
"data": [
{
"orderId": "743829153601634818",
"symbol": "BTC_USDT",
"positionId": 0,
"price": 100000,
"priceStr": "100000",
"vol": 10,
"leverage": 20,
"side": 1,
"category": 1,
"orderType": 1,
"dealAvgPrice": 0,
"dealAvgPriceStr": "0",
"dealVol": 0,
"orderMargin": 5,
"takerFee": 0,
"makerFee": 0,
"profit": 0,
"feeCurrency": "USDT",
"openType": 2,
"state": 2,
"externalOid": "_m_a6e614e4107e4d13893f9f4a3f46d2d8",
"errorCode": 0,
"usedMargin": 0,
"createTime": 1763013089831,
"updateTime": 1763013089904,
"positionMode": 2,
"reduceOnly": false,
"version": 1,
"showCancelReason": 0,
"showProfitRateShare": 0,
"bboTypeNum": 0,
"totalFee": 0,
"zeroSaveTotalFeeBinance": 0,
"zeroTradeTotalFeeBinance": 0
}
]
}
  • POST /api/v1/private/order/batch_query_with_external

Required Permission: View Order Details

Request Parameters: list collection

ParameterTypeRequiredDescription
symbolstringtrueContract
externalOidstringtrueExternal order id

Response Parameters:

ParameterTypeDescription
orderIdlongOrder ID
symbolstringContract
positionIdlongPosition id
pricedecimalOrder price
voldecimalOrder quantity
leveragelongLeverage
sideintOrder direction 1: open long,2: close short,3: open short,4: close long
categoryintOrder category:1: limit,2: forced-liquidation custody,3: custody close,4: ADL reduction
dealAvgPricedecimalAverage fill price
dealVoldecimalFilled quantity
orderMargindecimalOrder margin
takerFeedecimalTaker fee
makerFeedecimalMaker fee
profitdecimalClose PnL
feeCurrencystringFee currency
openTypeintOpen type,1: isolated,2: cross
stateintOrder status,1: pending,2: unfilled,3: filled,4: canceled,5: invalid
externalOidstringExternal order id
createTimedateCreated time
updateTimedateUpdated time
bboTypeNumintLimit order type - BBO type; 0: not BBO;1: opposite-1;2: opposite-5;3: same-side-1;4: same-side-5;
lossTrendintStop-loss price type;1: latest;2: fair;3: index
profitTrendintTake-profit price type;
takeProfitPricedecimalTake-profit price
stopLossPricedecimalStop-loss price
priceProtectintSpread protection 1: on;0: off
positionModeintPosition mode;1: dual-side;2: one-way