Cancel Pending Order

Cancels a pending order that has not yet been executed or filled.

Cancel Order applies only to pending orders — it does not close currently open positions. For active positions in One-Way Mode, use the reduceOnly: true flag when placing a new order via Place Order to safely close or reduce your position instead. (See: Essential Concepts You must know for more details.)

This endpoint allows users to cancel an existing pending order that is still in the order book and has not been executed.

You must provide both the symbol and orderId in the request body to identify which order to cancel.

If the order has already been filled or partially filled, only the remaining unfilled portion (if any) will be canceled.

Authentication with a valid API key and trade permission scope is required.

Cancel Order

delete

Required scopes

This endpoint requires the following scopes:

Authorizations

thirdPartyApiKeyAuth

api-keystringRequired

For third party retail API users

Body

application/json

symbolstringRequired

Trading symbol

Example: BTCUSDT.PERPPattern: ^[A-Z0-9]+(\.[A-Z0-9]+)?$

orderIdstring · uuidRequired

Responses

200

OK

application/json

Responseobject

400

Bad Request

application/json

401

Unauthorized

application/json

delete

/api/v1/trade/order

HTTPcURLJavaScriptPython

DELETE /api/v1/trade/order HTTP/1.1
Host: trading-api.flipster.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "symbol": "BTCUSDT.PERP",
  "orderId": "123e4567-e89b-12d3-a456-426614174000"
}

{}