`cancel_order`

Cancel an open or partially filled order placed by this user. Returns the order with its new state.

Scope: orders:write

Input

Name	Type	Required	Description
`order_id`	`string (uuid)`	Required	The id returned by place_order.

JSON Schema

input_schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "format": "uuid",
      "description": "The id returned by place_order."
    }
  },
  "required": [
    "order_id"
  ],
  "additionalProperties": false
}

Example

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cancel_order",
    "arguments": {
      "order_id": "0b6f3c2e-6a8f-4f7e-9d0e-2a51c4b7e913"
    }
  }
}

Result

{
  "id": "0b6f3c2e-6a8f-4f7e-9d0e-2a51c4b7e913",
  "state": "cancelled",
  "updated_at": "2026-10-16T19:24:40Z",
  "paper": true
}

Abbreviated; the full Order shape is returned, as in place_order.