Trade

All Orders (USER_DATA)

Get all account orders; active, canceled, or filled..

If orderId is set, it will get orders >= that orderId. Otherwise most recent orders are returned.
For some historical orders cummulativeQuoteQty will be < 0, meaning the data is not available at this time.
If startTime and/or endTime provided, orderId is not required

Weight(IP): 20

get/api/v3/allOrders

Query parameters

symbolstring required

Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

orderIdinteger

Order id

startTimeinteger

UTC timestamp in ms

endTimeinteger

UTC timestamp in ms

limitinteger

Example:5

Default 500; max 1000.

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.626

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, 2021a484ce871a72622See the full diff
- ▲
  for the query request parameter endTime, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter limit, the type/format was changed from integer/ to integer/int32
  request-parameter-type-changed
- ▲
  for the query request parameter orderId, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  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 startTime, 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