paradex_account_funding_payments
Track and analyze funding payment history in perpetual futures trading to understand its impact on P&L. Calculate costs, compare markets, and plan strategies based on funding schedules.
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
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_unix_ms | Yes | End time in unix milliseconds. | |
| market_id | No | Filter by market ID. | |
| start_unix_ms | Yes | Start time in unix milliseconds. |
Implementation Reference
- src/mcp_paradex/tools/account.py:130-163 (handler)Handler function implementing the paradex_account_funding_payments tool. It authenticates a Paradex client, constructs parameters for market and time range, calls fetch_funding_payments on the client, and returns the response. The @server.tool decorator registers it as an MCP tool. Input schema defined via Annotated parameters.@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