MCP Paradex Server

Instructions

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