MCP Paradex Server

Instructions

Execute trades on Paradex with precise control over all order parameters.

Use this tool when you need to:
- Enter a new position based on your trading strategy
- Set limit orders at specific price levels
- Create stop-loss or take-profit orders for risk management
- Implement complex trading strategies with conditional orders

This is the primary tool for executing your trading decisions on Paradex,
with full control over order type, size, price, and execution parameters.

Example use cases:
- Setting limit orders at key support/resistance levels
- Placing stop-limit orders to manage risk on existing positions
- Executing market orders for immediate entry or exit
- Creating reduce-only orders to ensure you don't flip position direction

Succesful response indicates that orders were queued for execution.
Check order status using order id.

Implementation Reference

• src/mcp_paradex/tools/orders.py:80-135 (handler)

  The core handler function for the 'paradex_create_order' tool. Decorated with @server.tool for registration. Constructs and submits an Order to the Paradex client, returns formatted OrderState.

  @server.tool(name="paradex_create_order")
  async def create_order(
      market_id: Annotated[str, Field(description="Market identifier.")],
      order_side: Annotated[OrderSideEnum, Field(description="Order side.")],
      order_type: Annotated[OrderTypeEnum, Field(description="Order type.")],
      size: Annotated[float, Field(description="Order size.")],
      price: Annotated[float, Field(description="Order price (required for LIMIT orders).")],
      trigger_price: Annotated[float, Field(description="Trigger price for stop limit orders.")],
      instruction: Annotated[
          InstructionEnum, Field(default="GTC", description="Instruction for order execution.")
      ],
      reduce_only: Annotated[bool, Field(default=False, description="Reduce-only flag.")],
      client_id: Annotated[str, Field(description="Client-specified order ID.")],
      ctx: Context = None,
  ) -> dict:
      """
      Execute trades on Paradex with precise control over all order parameters.
  
      Use this tool when you need to:
      - Enter a new position based on your trading strategy
      - Set limit orders at specific price levels
      - Create stop-loss or take-profit orders for risk management
      - Implement complex trading strategies with conditional orders
  
      This is the primary tool for executing your trading decisions on Paradex,
      with full control over order type, size, price, and execution parameters.
  
      Example use cases:
      - Setting limit orders at key support/resistance levels
      - Placing stop-limit orders to manage risk on existing positions
      - Executing market orders for immediate entry or exit
      - Creating reduce-only orders to ensure you don't flip position direction
  
      Succesful response indicates that orders were queued for execution.
      Check order status using order id.
      """
      client = await get_authenticated_paradex_client()
      o = Order(
          market=market_id,
          order_side=OrderSide(order_side),
          order_type=OrderType(order_type),
          size=Decimal(str(size)),
          client_id=client_id,
          limit_price=Decimal(str(price)) if price else Decimal(0),
          reduce_only=reduce_only,
          instruction=instruction,
          trigger_price=Decimal(str(trigger_price)) if trigger_price else None,
      )
      response = client.submit_order(o)
      order: OrderState = OrderState(**response)
      result = {
          "description": OrderState.__doc__.strip() if OrderState.__doc__ else None,
          "fields": OrderState.model_json_schema(),
          "results": order,
      }
      return result

• src/mcp_paradex/tools/orders.py:80-80 (registration)

  The @server.tool decorator registers the paradex_create_order tool with the FastMCP server.

  @server.tool(name="paradex_create_order")

• src/mcp_paradex/models.py:153-209 (schema)

  Pydantic schemas used by the tool: OrderTypeEnum, InstructionEnum, OrderSideEnum for input parameters; OrderState BaseModel for output validation and schema generation.

  OrderTypeEnum = Literal[
      "MARKET",
      "LIMIT",
      "STOP_LIMIT",
      "STOP_MARKET",
      "TAKE_PROFIT_LIMIT",
      "TAKE_PROFIT_MARKET",
      "STOP_LOSS_MARKET",
      "STOP_LOSS_LIMIT",
  ]
  
  # Define allowed instruction types
  InstructionEnum = Literal["GTC", "IOC", "POST_ONLY"]
  OrderSideEnum = Literal["BUY", "SELL"]
  
  
  class OrderState(BaseModel):
      """Order state model representing the current state of an order on Paradex."""
  
      id: Annotated[str, Field(description="Unique order identifier generated by Paradex")]
      account: Annotated[str, Field(description="Paradex Account")]
      market: Annotated[str, Field(description="Market")]
      side: Annotated[str, Field(description="Order side")]
      type: Annotated[str, Field(description="Order type")]
      size: Annotated[float, Field(description="Order size")]
      remaining_size: Annotated[float, Field(description="Remaining size of the order")]
      price: Annotated[float, Field(description="Order price. 0 for MARKET orders")]
      status: Annotated[str, Field(description="Order status")]
      created_at: Annotated[int, Field(description="Order creation time")]
      last_updated_at: Annotated[
          int, Field(description="Order last update time. No changes once status=CLOSED")
      ]
      timestamp: Annotated[int, Field(description="Order signature timestamp")]
      cancel_reason: Annotated[
          str, Field(description="Reason for order cancellation if it was closed by cancel")
      ]
      client_id: Annotated[
          str, Field(description="Client order id provided by the client at order creation")
      ]
      seq_no: Annotated[
          int,
          Field(
              description="Unique increasing number that is assigned to this order update and changes on every order update"
          ),
      ]
      instruction: Annotated[str, Field(description="Execution instruction for order matching")]
      avg_fill_price: Annotated[str, Field(description="Average fill price of the order")]
      stp: Annotated[str, Field(description="Self Trade Prevention mode")]
      received_at: Annotated[
          int, Field(description="Timestamp in milliseconds when order was received by API service")
      ]
      published_at: Annotated[
          int, Field(description="Timestamp in milliseconds when order was sent to the client")
      ]
      flags: Annotated[list[str], Field(description="Order flags, allow flag: REDUCE_ONLY")]
      trigger_price: Annotated[str, Field(description="Trigger price for stop order")]