List Transfers

Retrieves the transfer history for a portfolio, including deposits, withdrawals, and swaps. This endpoint is accessed through the organization API.

Request URL

GET https://ddp.definitive.fi/v2/organization/portfolios/{portfolioId}/transfers

Path Parameters

Parameter	Type	Required	Description
portfolioId	string	Yes	UUID of the portfolio

Query Parameters

Parameter	Type	Required	Description	Default
limit	number	No	Maximum number of transfers to return	20
cursor	string	No	Timestamp of the last item from the previous page (ISO string)	-
actionTypes	string	No	Comma-separated list: `deposit`, `withdraw`, or `swap`	all
startTimestamp	string	No	Start date filter (ISO 8601)	-
endTimestamp	string	No	End date filter (ISO 8601)	-

Action Types

These strings are used to filter specific types of transfer activity:

Action Type	Description
`deposit`	Inbound transfers into the portfolio vault
`withdraw`	Outbound transfers from the vault
`swap`	Internal swaps between vault assets

Example

const queryParams = {
  limit: 10,
  cursor: "2025-06-07T01:19:25.143Z",
  actionTypes: "deposit,withdraw"
};
 
const json = await AuthHelpers.signAndSend({
  path: "/v2/organization/portfolios/00000000-0000-0000-0000-000000000001/transfers",
  method: "GET",
  queryParams,
  organizationId: "00000000-0000-0000-0000-000000000000",
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});

Response

{
  transfers: [
    {
      transferId: "00000000-0000-0000-0000-000000000004",
      actionType: "deposit",
      asset: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      symbol: "USDC",
      amount: "1000.000000",
      amountUSD: "1000.00",
      timestamp: "2024-08-05T20:48:11.584Z",
      txHash: "0x1234567890abcdef...",
      status: "completed",
      chain: {
        name: "Ethereum",
        id: "1",
        namespace: "eip:155"
      },
      vault: {
        vaultId: "00000000-0000-0000-0000-000000000003",
        address: "0x0000000000000000000000000000000000000001"
      }
    }
    // ... additional transfers
  ],
  pagination: {
    limit: 10,
    nextCursor: "2025-06-07T01:19:25.143Z",
    hasMore: true
  }
}