Transfers

Retrieves the transfer history for a portfolio, including deposits and withdrawals across all vaults.

Request URL

https://ddp.definitive.fi/v1/portfolio/transfers

Query Parameters

Parameter	Type	Required	Description	Default
limit	number	No	Maximum number of transfers to return	10
offset	number	No	Number of transfers to skip for pagination	0
actionTypes	string[]	No	Filter transfers by action types (e.g. ["VAULT_ACTION_DEPOSIT", "VAULT_ACTION_WITHDRAWAL"])	-
startTimestamp	Date	No	Filter transfers after this timestamp (ISO 8601 format)	-
endTimestamp	Date	No	Filter transfers before this timestamp (ISO 8601 format)	-

Response

{
  transfers: [
    {
      vaultLedgerId: string, // e.g. "9f725289-ed42-42ee-8e03-10168fd764d0"
      vaultId: string, // e.g. "a1859005-cd44-4bda-83f7-c6253a39c805"
      vaultDelta: number, // e.g. 0.028363
      transactionId: string, // e.g. "0xc5f5f8bb9c82214f1d25e8b8711a1fb27aad93c21bc3c235c26cdef20821ec9c"
      timestamp: string, // ISO date string e.g. "2025-03-12T07:35:10.233Z"
      actionType: string, // e.g. "VAULT_ACTION_DEPOSIT"
      notionalValue: number, // e.g. 0.028357525940999998
      asset: {
        id: string, // e.g. "bcf2f301-1db9-4e12-b3fd-da79e91d3940"
        name: string, // e.g. "USDC"
        ticker: string, // e.g. "USDC"
        address: string, // e.g. "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        chain: {
          id: string, // e.g. "8453"
          name: string, // e.g. "Base"
          namespace: string // e.g. "eip155"
        }
      }
    }
    // ... additional transfers
  ],
  limit: number, // e.g. 10
  offset: number, // e.g. 0
  totalCount: number // Total number of transfers available, e.g. 1387945
}

Example

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