Skip to content

Cancel Orders

This endpoint allows you to cancel an existing order that hasn't been fully filled.

Request URL

https://ddp.definitive.fi/v1/trade/:orderId

Where :orderId is the ID of the order you want to cancel, obtained from the order submission response or the orders list.

Response

{
  "success": true,
  "message": "Order cancelled successfully"
}

If the order cannot be cancelled (for example, if it's already filled or doesn't exist), the response will indicate failure:

{
  "success": false,
  "message": "Order not found or cannot be cancelled"
}

Example

const orderId = "e12f34a5-b678-90cd-12ef-3456abcd7890";
 
const response = await AuthHelpers.signAndSend({
  path: `/v1/trade/${orderId}`,
  method: "DELETE",
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});
console.log(response);

Common Use Cases

  • Cancelling a limit order that hasn't been filled
  • Cancelling a TWAP order that's partially filled but you want to stop the remaining execution
  • Cancelling an order that was submitted in error

Notes

  • Cancellation is only possible for orders that have not been fully filled
  • Market orders typically execute immediately and may not be cancellable
  • TWAP orders can be cancelled mid-execution, stopping any remaining unfilled portions
  • Once an order is cancelled, it cannot be reactivated - you would need to submit a new order