MCP Paradex Server

Instructions

Check the detailed status of a specific order for execution monitoring.

Use this tool when you need to:
- Confirm if a particular order was accepted and is active
- Check if an order has been filled, partially filled, or canceled
- Get execution details for a specific order
- Diagnose issues with order placement
- Track the status of important orders individually

Order status tracking is essential for verifying execution status
and troubleshooting any issues with specific orders.

Example use cases:
- Checking if a recently placed limit order is active in the book
- Verifying fill details of a specific order
- Determining why an order might have been rejected
- Confirming cancellation status of an order you attempted to cancel
- Getting execution timestamps for order lifecycle analysis

Implementation Reference

• src/mcp_paradex/tools/orders.py:189-228 (handler)

  The handler function for the 'paradex_order_status' tool. It retrieves the status of a specific order using either order_id or client_id via the Paradex client, validates it with OrderState model, and returns a structured result including schema information.

  @server.tool(name="paradex_order_status")
  async def get_order_status(
      order_id: Annotated[str, Field(description="Order identifier.")],
      client_id: Annotated[str, Field(description="Client-specified order ID.")],
      ctx: Context = None,
  ) -> dict:
      """
      Check the detailed status of a specific order for execution monitoring.
  
      Use this tool when you need to:
      - Confirm if a particular order was accepted and is active
      - Check if an order has been filled, partially filled, or canceled
      - Get execution details for a specific order
      - Diagnose issues with order placement
      - Track the status of important orders individually
  
      Order status tracking is essential for verifying execution status
      and troubleshooting any issues with specific orders.
  
      Example use cases:
      - Checking if a recently placed limit order is active in the book
      - Verifying fill details of a specific order
      - Determining why an order might have been rejected
      - Confirming cancellation status of an order you attempted to cancel
      - Getting execution timestamps for order lifecycle analysis
      """
      client = await get_authenticated_paradex_client()
      if order_id:
          response = client.fetch_order(order_id)
      elif client_id:
          response = client.fetch_order_by_client_id(client_id)
      else:
          raise Exception("Either order_id or client_id must be provided.")
      order: OrderState = OrderState.model_validate(response)
      result = {
          "description": OrderState.__doc__.strip() if OrderState.__doc__ else None,
          "fields": OrderState.model_json_schema(),
          "results": order,
      }
      return result