paradex_vault_transfers
Track deposit and withdrawal history for auditing and reconciliation, verifying transaction status and analyzing capital movement patterns.
Instructions
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
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vault_address | Yes | The address of the vault to get transfers for. |
Implementation Reference
- src/mcp_paradex/tools/vaults.py:236-275 (handler)The handler function decorated with @server.tool for the paradex_vault_transfers tool. It fetches the transfer history for a given vault address via the Paradex API and returns the results or an error response.@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, }
- src/mcp_paradex/tools/vaults.py:236-236 (registration)The @server.tool decorator registers the get_vault_transfers function as the MCP tool named paradex_vault_transfers.@server.tool(name="paradex_vault_transfers")
- The function signature defines the input schema using Pydantic Annotated and Field for the vault_address parameter, and returns dict[str, Any] for transfer data.async def get_vault_transfers( vault_address: Annotated[ str, Field(description="The address of the vault to get transfers for.") ], ) -> dict[str, Any]: