MCP Paradex Server

Instructions

Track your funding payment history to understand its impact on P&L.

Use this tool when you need to:
- Calculate total funding costs or gains for a position
- Analyze how funding has affected your overall performance
- Plan position timing around funding payment schedules
- Compare funding costs across different markets
- Account for funding in your trading strategy profitability

Funding payments can significantly impact perpetual futures trading P&L,
especially for longer-term positions or in markets with volatile funding rates.

Example use cases:
- Calculating the total funding component of your P&L
- Comparing funding costs against trading profits
- Planning position entries/exits around funding payment times
- Identifying markets where funding has been consistently favorable
- Reconciling funding payments for accounting purposes

Implementation Reference

• src/mcp_paradex/tools/account.py:130-162 (handler)

  The handler function for the 'paradex_account_funding_payments' tool. It is registered via the @server.tool decorator and implements the logic to fetch funding payments from the Paradex client using provided parameters (optional market_id and required time range). The function parameters with Annotated types define the input schema. It returns the raw API response.

  @server.tool(name="paradex_account_funding_payments")
  async def get_account_funding_payments(
      market_id: Annotated[str | None, Field(default=None, description="Filter by market ID.")],
      start_unix_ms: Annotated[int, Field(description="Start time in unix milliseconds.")],
      end_unix_ms: Annotated[int, Field(description="End time in unix milliseconds.")],
      ctx: Context = None,
  ) -> dict:
      """
      Track your funding payment history to understand its impact on P&L.
  
      Use this tool when you need to:
      - Calculate total funding costs or gains for a position
      - Analyze how funding has affected your overall performance
      - Plan position timing around funding payment schedules
      - Compare funding costs across different markets
      - Account for funding in your trading strategy profitability
  
      Funding payments can significantly impact perpetual futures trading P&L,
      especially for longer-term positions or in markets with volatile funding rates.
  
      Example use cases:
      - Calculating the total funding component of your P&L
      - Comparing funding costs against trading profits
      - Planning position entries/exits around funding payment times
      - Identifying markets where funding has been consistently favorable
      - Reconciling funding payments for accounting purposes
      """
      client = await get_authenticated_paradex_client()
      params = {"market": market_id, "start_at": start_unix_ms, "end_at": end_unix_ms}
      # Remove None values from params
      params = {k: v for k, v in params.items() if v is not None}
      response = client.fetch_funding_payments(params)
      return response