Action Types

This page documents all possible action types used throughout the Definitive API. These action types are used in transfer history, vault operations, and portfolio management endpoints.

Available Action Types

Action Type Categories

Transfer Actions

These action types represent different types of asset movements:

• VAULT_ACTION_DEPOSIT: Used when assets are deposited into a vault from an external source
• VAULT_ACTION_WITHDRAW: Used when assets are withdrawn from a vault to an external destination
• VAULT_ACTION_SWAP: Used when assets are swapped within the vault (e.g., USDC to ETH)

Bridge Actions

These action types represent cross-chain bridge operations:

• VAULT_ACTION_BRIDGE_SEND: Used when assets are sent from a vault to another chain via a bridge (e.g., USDC from Base to Solana). The vaultDelta will be negative.
• VAULT_ACTION_BRIDGE_RECEIVE: Used when assets are received into a vault from another chain via a bridge (e.g., USDC from Solana to Base). The vaultDelta will be positive.

Usage in API Endpoints

Action types are used as filter parameters in the following API endpoint:

• List Transfers

Example Usage

// Filter for deposits and withdrawals only
const queryParams = {
  actionTypes: "VAULT_ACTION_DEPOSIT,VAULT_ACTION_WITHDRAW",
};
 
// Filter for bridge history only
const queryParams = {
  actionTypes: "VAULT_ACTION_BRIDGE_SEND,VAULT_ACTION_BRIDGE_RECEIVE",
};
 
// Filter for all action types
const queryParams = {
  actionTypes: "VAULT_ACTION_DEPOSIT,VAULT_ACTION_WITHDRAW,VAULT_ACTION_SWAP,VAULT_ACTION_BRIDGE_SEND,VAULT_ACTION_BRIDGE_RECEIVE",
};

Related Endpoints

These action types are used in the following API endpoint:

• List Transfers