Skip to Content
🚀 Spot APITrading APIQuery Open Orders

Query Open Orders

Request URL

GET /stapi/v1/openOrders

Request Parameters

NameTypeRequiredDescription
symbolSTRINGNOTrading pair
orderIdLONGNOStarting order ID
clientOrderIdSTRINGNO客户端自定义订单ID
startTimeLONGNOStart time (milliseconds)
endTimeLONGNOEnd time (milliseconds)
limitINTNOReturn limit, maximum 200
offsetLONGNOOffset, query results sorted by offset in descending order
typeENUMNOOrder type, see OrderType
statusENUMNOOrder status, see OrderStatus
sideENUMNOBuy/sell direction, see OrderSide

Response Parameters

NameTypeDescription
codeSTRINGResponse Code
msgSTRINGResponse Message
successBOOLEANSuccess Flag
dataARRAYData Payload
data[].cancelQtySTRINGCanceled Base Quantity
data[].cancelQuoteQtySTRINGCanceled Quote Quantity
data[].cancelReasonSTRINGCancel Reason
data[].executedAvgPriceSTRINGAverage Executed Price
data[].executedQtySTRINGExecuted Base Quantity
data[].executedQuoteQtySTRINGExecuted Quote Quantity
data[].feeSTRINGFee
data[].feeAssetSTRINGFee Asset
data[].mtimeINTEGERUpdate Time
data[].offsetINTEGEROffset
data[].orderIdSTRINGOrder ID
data[].clientOrderIdSTRINGClient Order ID
data[].orderTimeINTEGEROrder Time
data[].originQtySTRINGOriginal Base Quantity
data[].originQuoteQtySTRINGOriginal Quote Quantity
data[].postOnlyINTEGERPost Only
data[].priceSTRINGPrice
data[].remainQtySTRINGRemaining Base Quantity
data[].sideSTRINGOrder Side
data[].statusSTRINGOrder Status
data[].symbolSTRINGSymbol
data[].timeInForceSTRINGTime In Force
data[].typeSTRINGOrder Type

Request Example

https://openapi.bittap.com/stapi/v1/openOrders?symbol=BTC-USDT

Response Example

{ "code": "0", "data": [ { "cancelQty": "0.00000000000000000000",//Canceled base quantity "cancelQuoteQty": "0.00000000000000000000",//Canceled quote quantity "cancelReason": "NONE",//Cancel reason "executedAvgPrice": "0",//Average execution price "executedQty": "0.00000000000000000000",//Executed base quantity "executedQuoteQty": "0.00000000000000000000",//Executed quote quantity "fee": "0.00000000000000000000",//Fee "feeAsset": "BTC",//Fee asset "mtime": 1756374735000,//Update time "offset": 149947,//Offset "orderId": "86880543836213248",//Order ID "clientOrderId": "3df07fac151306b5aa08633191ec15d2",//Client order ID "orderTime": 1756374736000,//Order time "originQty": "0.00110000000000000000",//Original base quantity "originQuoteQty": null,//Original quote quantity "postOnly": 0,//Post only flag "price": "100002.00000000000000000000",//Price "remainQty": "0.00110000000000000000",//Remaining base quantity "side": "BUY",//Buy/sell direction "status": "OPEN",//Status "symbol": "BTC-USDT",//Trading pair "timeInForce": "GTC",//Time in force "type": "LIMIT"//Order type } ], "msg": "Request successful", "success": true }

Error Codes

Error CodeDescription
500Internal Server Error

Code Example

Last updated on: