Guides
Guides

Cancel order by id

Cancel a specific order using its unique ID.

The order's currency is inherited from its UUID.

Request

# By Mudrex order UUID (path)
curl -X DELETE "https://trade.mudrex.com/fapi/v1/futures/orders/{order_id}" \
  -H "X-Authentication: your-secret-key"
# By client_order_id (query)
curl -X DELETE "https://trade.mudrex.com/fapi/v1/futures/orders?client_order_id=my-order-123" \
  -H "X-Authentication: your-secret-key"

Parameters

ParameterTypeRequiredDescription
order_idstringConditionalMudrex order UUID as a path parameter. Required unless cancelling by client_order_id.
client_order_idstringConditionalQuery parameter. Your client-supplied order id. Use instead of the path order_id.

Response

Status: 200 OK

{
    "success": true,
    "data": {
        "message": "OK",
        "order_id": "01a0b555-10ad-760d-841c-a595676988cc",
        "status": "CANCELLED"
    }
}

Note: Some successful cancels may still return empty strings for message, order_id, and status. Prefer confirming via Get Order / Open orders after cancel.

Response fields

FieldDescription
messageStatus message.
order_idID of the cancelled order.
statusStatus of the order.

In testing, a successful INR cancellation returned 200 OK with these data fields present but empty.

Errors

❕Common errors

Order already deleted — 400 Bad Request. Occurs when the order has already been cancelled or deleted.

Invalid order ID — 404 Not Found. Occurs when the provided order ID does not exist.


Did this page help you?