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 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"
      }
    }
  ]
}

Changes

Changed in 7 of the 46 revisions of this API.1136

Jul 8, 202658e4ebe85a8f12See the full diff
- ▲
  added EarnFeeCollectActionResponse to the data/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  added the new enum value earn_fee_collect to the query request parameter type
  request-parameter-enum-value-added
- ○
  added earn_fee_collect discriminator mapping keys to the data/items/ response property for the response status 200
  response-property-discriminator-mapping-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 26, 2026c10a42ebeddb525See the full diff
- ▲
  the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ○
  added EVMUserOperationEntrypointVersion subschema #2 to the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added EVMUserOperationEntrypointVersion subschema #2 to the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added EVMUserOperationEntrypointVersion subschema #2 to the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added EVMUserOperationEntrypointVersion subschema #2 to the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added EVMUserOperationEntrypointVersion subschema #2 to the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property allOf list for the response status 200
  response-property-all-of-added
- ○
  removed the 0.6 enum value from the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.6 enum value from the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.6 enum value from the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.6 enum value from the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.6 enum value from the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.7 enum value from the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.7 enum value from the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.7 enum value from the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.7 enum value from the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.7 enum value from the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.8 enum value from the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.8 enum value from the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.8 enum value from the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.8 enum value from the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.8 enum value from the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.9 enum value from the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.9 enum value from the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.9 enum value from the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.9 enum value from the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 0.9 enum value from the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/entrypoint_version response property for the response status 200
  response-property-enum-value-removed
Jun 23, 20269955c27139f355See the full diff
- ▲
  added TVMTransactionWalletActionStep to the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added TVMTransactionWalletActionStep to the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added TVMTransactionWalletActionStep to the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added TVMTransactionWalletActionStep to the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added TVMTransactionWalletActionStep to the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  added tvm_transaction discriminator mapping keys to the data/items/oneOf[subschema #1: SwapActionResponse]/steps/items/ response property for the response status 200
  response-property-discriminator-mapping-added
- ○
  added tvm_transaction discriminator mapping keys to the data/items/oneOf[subschema #2: TransferActionResponse]/steps/items/ response property for the response status 200
  response-property-discriminator-mapping-added
- ○
  added tvm_transaction discriminator mapping keys to the data/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/ response property for the response status 200
  response-property-discriminator-mapping-added
- ○
  added tvm_transaction discriminator mapping keys to the data/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/ response property for the response status 200
  response-property-discriminator-mapping-added
- ○
  added tvm_transaction discriminator mapping keys to the data/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/ response property for the response status 200
  response-property-discriminator-mapping-added
Jun 17, 2026468dcf8db5801See the full diff
- ○
  added the optional property data/items/oneOf[subschema #2: TransferActionResponse]/amount_type to the response with the 200 status
  response-optional-property-added
Jun 16, 2026041ff933be961See the full diff
- ○
  added the new optional query request parameter type
  new-optional-request-parameter
Jun 16, 20268f9eb26a22481See the full diff
- ○
  added the optional property data/items/oneOf[subschema #1: SwapActionResponse]/destination_address to the response with the 200 status
  response-optional-property-added
Jun 12, 2026a8d27de9e15d1See the full diff
- ○
  endpoint added
  endpoint-added

Full history