List Transfers

Retrieves the transfer history for a portfolio, including deposits, withdrawals, swaps, and cross-chain bridge transfers across all vaults.

Endpoint

Portfolio API: GET https://ddp.definitive.fi/v2/portfolio/transfers

Organization API: Replace /v2/portfolio/ with /v2/organization/portfolios/{portfolioId}/. See Portfolio vs. Organization API.

Query Parameters

Parameter	Type	Required	Description	Default
limit	number	No	Maximum number of transfers to return	100
cursor	string	No	Timestamp of the last item from the previous page (ISO string)	-
actionTypes	string	No	Comma-separated list of action types to filter by (e.g. "VAULT_ACTION_DEPOSIT,VAULT_ACTION_BRIDGE_SEND")	-
startTimestamp	string	No	Start date filter (ISO 8601)	-
endTimestamp	string	No	End date filter (ISO 8601)	-

Examples

const json = await AuthHelpers.signAndSend({
  path: "/v2/portfolio/transfers",
  method: "GET",
  queryParams: {
    limit: "10",
    actionTypes: "VAULT_ACTION_DEPOSIT,VAULT_ACTION_WITHDRAW",
    startTimestamp: new Date("2024-01-01").toISOString(),
    endTimestamp: new Date("2024-12-31").toISOString(),
  },
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});

Response

{
  transfers: [
    {
      vaultLedgerId: string, // e.g. "00000000-0000-0000-0000-000000000001"
      vaultId: string, // e.g. "00000000-0000-0000-0000-000000000002"
      vaultDelta: number, // e.g. 100.50 (negative for outbound, e.g. -100.50 for sends/withdrawals)
      transactionId: string, // e.g. "0xabc123..."
      timestamp: string, // ISO date string e.g. "2025-01-15T12:00:00.000Z"
      actionType: string, // e.g. "VAULT_ACTION_DEPOSIT"
      notionalValue: number, // e.g. 100.50 (USD value)
      asset: {
        id: string,
        name: string,
        ticker: string,
        address: string,
        chain: {
          id: string,
          name: string,
          namespace: string
        }
      }
    }
    // ... additional transfers
  ],
  limit: number, // e.g. 10
  nextCursor: string, // e.g. "2025-01-15T12:00:00.000Z"
  hasMore: boolean // Indicates if there are more transfers available
}

Action Types

For a complete list of available action types, see Action Types.

To retrieve only bridge history, filter with:

?actionTypes=VAULT_ACTION_BRIDGE_SEND,VAULT_ACTION_BRIDGE_RECEIVE