v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Wallet Actions

List wallet actions

List all wallet actions for a wallet, with optional filtering by type and status. Supports cursor-based pagination.

get/v1/wallets/{wallet_id}/actions

Path parameters

wallet_idstring required

ID of the wallet.

Query parameters

cursorstring
limitnumber nullable
type'swap' | 'transfer' | 'earn_deposit' | 'earn_withdraw' | 'earn_incentive_claim' | 'earn_fee_collect'

Type of wallet action

Headers

privy-app-idstring required

ID of your Privy app.

privy-authorization-signaturestring

Request authorization signature. If multiple signatures are required, they should be comma separated.

Response

Paginated list of wallet actions.

next_cursorstring nullable required

Example response

{
  "data": [
    {
      "estimated_fees": [
        {
          "amount": "0.20",
          "recipient": "0x1234567890abcdef1234567890abcdef12345678",
          "type": "relayer"
        }
      ],
      "estimated_gas": {
        "amount": "0.0001",
        "base_amount": "100000000000000",
        "gas_asset": "ETH"
      },
      "fees": [
        {
          "amount": "0.20",
          "recipient": "0x1234567890abcdef1234567890abcdef12345678",
          "type": "relayer"
        }
      ],
      "gas": {
        "amount": "0.0001",
        "base_amount": "100000000000000",
        "gas_asset": "ETH"
      }
    }
  ]
}