paradex_cancel_orders
Cancel pending orders to manage trading exposure, adjust strategies, or respond to market changes. Remove specific orders or clear all orders when needed.
Instructions
Cancel pending orders to manage exposure or adjust your trading strategy.
Use this tool when you need to:
- Remove stale limit orders that are no longer desirable
- Quickly reduce market exposure during volatility
- Update your order strategy by removing existing orders
- Clear your order book before implementing a new strategy
- React to changing market conditions by canceling pending orders
Order cancellation is a critical risk management function and allows you
to quickly adapt to changing market conditions.
Example use cases:
- Canceling limit orders when your outlook changes
- Removing all orders during unexpected market volatility
- Canceling a specific order identified by order ID
- Clearing all orders for a specific market
- Removing stale orders before placing new ones
Calling without any parameters will cancel all orders.
Succesful response indicates that orders were queued for cancellation.
Check order status using order id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | No | Order id (received from create_order) | |
| client_id | No | Client id (provided by you on create_order) | |
| market_id | No | Market is the market to cancel orders for | ALL |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Unique order identifier generated by Paradex | |
| stp | Yes | Self Trade Prevention mode | |
| side | Yes | Order side | |
| size | Yes | Order size | |
| type | Yes | Order type | |
| flags | Yes | Order flags, allow flag: REDUCE_ONLY | |
| price | Yes | Order price. 0 for MARKET orders | |
| market | Yes | Market | |
| seq_no | Yes | Unique increasing number that is assigned to this order update and changes on every order update | |
| status | Yes | Order status | |
| account | Yes | Paradex Account | |
| client_id | Yes | Client order id provided by the client at order creation | |
| timestamp | Yes | Order signature timestamp | |
| created_at | Yes | Order creation time | |
| instruction | Yes | Execution instruction for order matching | |
| received_at | Yes | Timestamp in milliseconds when order was received by API service | |
| published_at | Yes | Timestamp in milliseconds when order was sent to the client | |
| cancel_reason | Yes | Reason for order cancellation if it was closed by cancel | |
| trigger_price | Yes | Trigger price for stop order | |
| avg_fill_price | Yes | Average fill price of the order | |
| remaining_size | Yes | Remaining size of the order | |
| last_updated_at | Yes | Order last update time. No changes once status=CLOSED |
Implementation Reference
- src/mcp_paradex/tools/orders.py:138-186 (handler)The handler function decorated with @server.tool(name="paradex_cancel_orders"). This implements the core logic: authenticates a Paradex client and calls cancel_order, cancel_order_by_client_id, or cancel_all_orders based on provided parameters, returning the OrderState.
@server.tool(name="paradex_cancel_orders") async def cancel_orders( order_id: Annotated[ str, Field(default="", description="Order id (received from create_order)") ], client_id: Annotated[ str, Field(default="", description="Client id (provided by you on create_order)") ], market_id: Annotated[ str, Field(default="ALL", description="Market is the market to cancel orders for") ], ctx: Context = None, ) -> OrderState: """ Cancel pending orders to manage exposure or adjust your trading strategy. Use this tool when you need to: - Remove stale limit orders that are no longer desirable - Quickly reduce market exposure during volatility - Update your order strategy by removing existing orders - Clear your order book before implementing a new strategy - React to changing market conditions by canceling pending orders Order cancellation is a critical risk management function and allows you to quickly adapt to changing market conditions. Example use cases: - Canceling limit orders when your outlook changes - Removing all orders during unexpected market volatility - Canceling a specific order identified by order ID - Clearing all orders for a specific market - Removing stale orders before placing new ones Calling without any parameters will cancel all orders. Succesful response indicates that orders were queued for cancellation. Check order status using order id. """ client = await get_authenticated_paradex_client() if order_id: response = client.cancel_order(order_id) elif client_id: response = client.cancel_order_by_client_id(client_id) elif market_id: response = client.cancel_all_orders(market_id) else: raise Exception("Either order_id or client_id must be provided.") order = OrderState(**response) return order - Pydantic Field annotations defining the input schema for the paradex_cancel_orders tool, including order_id, client_id, and market_id parameters.
order_id: Annotated[ str, Field(default="", description="Order id (received from create_order)") ], client_id: Annotated[ str, Field(default="", description="Client id (provided by you on create_order)") ], market_id: Annotated[ str, Field(default="ALL", description="Market is the market to cancel orders for") ], ctx: Context = None, ) -> OrderState: - src/mcp_paradex/tools/orders.py:138-138 (registration)The @server.tool decorator registers the cancel_orders function as the MCP tool named 'paradex_cancel_orders'.
@server.tool(name="paradex_cancel_orders") - Uses the helper get_authenticated_paradex_client() to obtain the Paradex client for cancellation operations.
client = await get_authenticated_paradex_client()