Skip to main content

Query User's UM Force Orders (USER_DATA)

API Description#

Query User's UM Force Orders

HTTP Request#

GET /papi/v1/um/forceOrders

Request Weight#

20 with symbol, 50 without symbol

Request Parameters#

NameTypeMandatoryDescription
symbolSTRINGNO
autoCloseTypeENUMNOLIQUIDATION for liquidation orders, ADL for ADL orders.
startTimeLONGNO
endTimeLONGNO
limitINTNODefault 50; max 100.
recvWindowLONGNOThe value cannot be greater than 60000
timestampLONGYES
  • If autoCloseType is not sent, orders with both of the types will be returned
  • If startTime is not sent, data within 7 days before endTime can be queried

Response Example#

[  {    "orderId": 6071832819,     "symbol": "BTCUSDT",     "status": "FILLED",     "clientOrderId": "autoclose-1596107620040000020",     "price": "10871.09",     "avgPrice": "10913.21000",     "origQty": "0.001",     "executedQty": "0.001",     "cumQuote": "10.91321",     "timeInForce": "IOC",     "type": "LIMIT",     "reduceOnly": false,     "side": "SELL",     "positionSide": "BOTH",     "origType": "LIMIT",     "time": 1596107620044,     "updateTime": 1596107620087  }]