User's Force Orders

Type: USER-DATA

Weight: 5

GET /fapi/v1/forceOrders

Your liquidation events.

Request

GET /fapi/v1/forceOrders?symbol=BTCUSDT&limit=100&timestamp=<ms>&signature=<hex>

Query params

Name	Type	Required	Default	Notes
symbol	string	no	—
autoCloseType	string	no	—	Not supported; all liquidation events are returned.
startTime / endTime	long	no	—	Ignored.
limit	integer	no	100	max 1000

Response — 200

[
  {
    "orderId": "liq-uuid",
    "symbol": "BTCUSDT",
    "status": "FILLED",
    "side": "SELL",
    "type": "LIQUIDATION",
    "price": "55000.00",
    "origQty": "0.5",
    "executedQty": "0.5",
    "time": 1714261234567,
    "updateTime": 1714261234567
  }
]

Rows come from the liquidation-events table and include both liquidations and ADL closes; status is always FILLED.

Authentication failures (INVALID_API_KEY, API_KEY_DISABLED, IP_NOT_ALLOWED, SIGNATURE_INVALID) apply to every signed endpoint and use Sparky's {"success":false,"error":{...}} envelope; see Error Codes.