MCP Paradex Server

Instructions

Implementation Reference

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

  The main 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 time range and optional market ID filter. The input schema is defined inline via Annotated Fields.
  @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