Trade

Current Open Orders (USER_DATA)

Get all open orders on a symbol. Careful when accessing this with no symbol.

Weight(IP):

6 for a single symbol;
80 when the symbol parameter is omitted;

get/api/v3/openOrders

Query parameters

symbolstring

Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Current open orders

symbolstring required

orderIdinteger required

orderListIdinteger required

Unless OCO, value will be -1

clientOrderIdstring required

pricestring required

origQtystring required

executedQtystring required

cummulativeQuoteQtystring required

statusstring required

timeInForcestring required

typestring required

sidestring required

stopPricestring required

icebergQtystring required

timeinteger required

updateTimeinteger required

isWorkingboolean required

workingTimeinteger required

origQuoteOrderQtystring required

selfTradePreventionModestring required

preventedMatchIdinteger

preventedQuantitystring

Example response

[
  {
    "symbol": "LTCBTC",
    "orderId": 1,
    "orderListId": -1,
    "clientOrderId": "myOrder1",
    "price": "0.1",
    "origQty": "1.0",
    "executedQty": "0.0",
    "cummulativeQuoteQty": "0.0",
    "status": "NEW",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY",
    "stopPrice": "0.0",
    "icebergQty": "0.0",
    "time": 1499827319559,
    "updateTime": 1499827319559,
    "workingTime": 1499827319559,
    "origQuoteOrderQty": "0.00000000",
    "selfTradePreventionMode": "NONE",
    "preventedQuantity": "1.200000"
  }
]

Changes

Changed in 3 of the 26 revisions of this API.226

Sep 2, 20236622e0c151002See the full diff
- ○
  added the optional property items/preventedMatchId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/preventedQuantity to the response with the 200 status
  response-optional-property-added
Apr 26, 2023042dad2ebffe2See the full diff
- ○
  added the required property items/selfTradePreventionMode to the response with the 200 status
  response-required-property-added
- ○
  added the required property items/workingTime to the response with the 200 status
  response-required-property-added
Oct 25, 2021a484ce871a72222See the full diff
- ▲
  for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property code became required for the status 401
  response-property-became-required
- ○
  the response property items/clientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property items/cummulativeQuoteQty became required for the status 200
  response-property-became-required
- ○
  the response property items/executedQty became required for the status 200
  response-property-became-required
- ○
  the response property items/icebergQty became required for the status 200
  response-property-became-required
- ○
  the response property items/isWorking became required for the status 200
  response-property-became-required
- ○
  the response property items/orderId became required for the status 200
  response-property-became-required
- ○
  the response property items/orderListId became required for the status 200
  response-property-became-required
- ○
  the response property items/origQty became required for the status 200
  response-property-became-required
- ○
  the response property items/origQuoteOrderQty became required for the status 200
  response-property-became-required
- ○
  the response property items/price became required for the status 200
  response-property-became-required
- ○
  the response property items/side became required for the status 200
  response-property-became-required
- ○
  the response property items/status became required for the status 200
  response-property-became-required
- ○
  the response property items/stopPrice became required for the status 200
  response-property-became-required
- ○
  the response property items/symbol became required for the status 200
  response-property-became-required
- ○
  the response property items/time became required for the status 200
  response-property-became-required
- ○
  the response property items/timeInForce became required for the status 200
  response-property-became-required
- ○
  the response property items/type became required for the status 200
  response-property-became-required
- ○
  the response property items/updateTime became required for the status 200
  response-property-became-required
- ○
  the response property msg became required for the status 400
  response-property-became-required
- ○
  the response property msg became required for the status 401
  response-property-became-required

Full history