MCP Paradex Server

Instructions

Implementation Reference

• src/mcp_paradex/tools/vaults.py:236-275 (handler)

  The handler function for the 'paradex_vault_transfers' tool. It takes a vault_address parameter and fetches the transfer history from the Paradex API using api_call to 'vaults/transfers'. Returns the results or an error dict on failure.
  @server.tool(name="paradex_vault_transfers") async def get_vault_transfers( vault_address: Annotated[ str, Field(description="The address of the vault to get transfers for.") ], ) -> dict[str, Any]: """ Track deposit and withdrawal history for auditing and reconciliation. Use this tool when you need to: - Verify deposits have completed and are available for trading - Track withdrawal status and confirm transaction settlement - Audit the complete fund flow history for a vault - Reconcile on-chain transactions with platform records - Understand historical capital allocation patterns Complete transfer history is essential for proper accounting and provides a clear audit trail of all capital movements. Example use cases: - Confirming that a recent deposit was credited to your account - Tracking the status of pending withdrawals - Creating transaction reports for accounting or tax purposes - Verifying the total amount deposited over time - Analyzing deposit/withdrawal patterns for strategy insights """ try: client = await get_paradex_client() response = await api_call(client, "vaults/transfers", params={"address": vault_address}) return response["results"] except Exception as e: logger.error(f"Error fetching transfers for vault {vault_address}: {e!s}") return { "success": False, "timestamp": datetime.now().isoformat(), "environment": config.ENVIRONMENT, "error": str(e), "transfers": None, }