Skip to main content

Query Order

Query order status for a symbol (up to 7 days); older orders can be viewed and exported in the web client.

HTTP Request

  • GET /api/v3/order

Required Permission: SPOT_DEAL_READ

Weight(IP): 2

Request Parameters

NameTypeMandatoryDescription
symbolStringYES
origClientOrderIdStringNO
orderIdStringNO
recvWindowlongNO
timestamplongYES

Response Parameters

NameDescription
symbolSymbol
origClientOrderIdOriginal client order id
orderIdorder id
clientOrderIdclient order id
pricePrice
QtyOriginal order quantity
executedQtyExecuted order quantity
cummulativeQuoteQtyCummulative quote quantity
statusENUM: Order Status
timeInForce
typeENUM: Order Type
sideENUM: Order Side
stopPricestop price
icebergQtyIceberg order quantity
timeOrder created time
updateTimeLast update time
isWorkingis orderbook
stpMode“” - Default value, no restriction on self-trading.“cancel_maker” - Cancel the maker order.“cancel_taker” - Cancel the taker order.“cancel_both” - Cancel both sides.
cancelReasoncancel reason.stp_cancel: canceled due to STP rules.
origQuoteOrderQtyOriginal quote order quantity

Response

{
"symbol": "LTCBTC",
"orderId": 1,
"orderListId": -1,
"clientOrderId": "myOrder1",
"price": "0.1",
"Qty": "1.0",
"executedQty": "0.0",
"cummulativeQuoteQty": "0.0",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"stopPrice": "0.0",
"time": 1499827319559,
"updateTime": 1499827319559,
"stpMode":"",
"cancelReason":"stp_cancel",
"isWorking": true,
"origQuoteOrderQty": "0.000000"
}