Skip to main content
GET
/
v1
/
wallets
/
{wallet_id}
/
actions
List wallet actions
curl --request GET \
  --url https://api.privy.io/v1/wallets/{wallet_id}/actions \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
{
  "data": [
    {
      "id": "<string>",
      "wallet_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "type": "swap",
      "caip2": "<string>",
      "input_token": "<string>",
      "output_token": "<string>",
      "input_amount": "<string>",
      "output_amount": "<string>",
      "failure_reason": {
        "message": "<string>",
        "details": "<unknown>"
      },
      "steps": [
        {
          "type": "evm_transaction",
          "caip2": "<string>",
          "transaction_hash": "<string>",
          "failure_reason": {
            "message": "<string>",
            "details": "<unknown>"
          },
          "finalized": true
        }
      ],
      "destination_caip2": "<string>",
      "destination_address": "<string>",
      "estimated_fees": [
        {
          "type": "privy",
          "recipient": "0x1234567890abcdef1234567890abcdef12345678",
          "amount": "0.20"
        }
      ],
      "estimated_gas": {
        "base_amount": "100000000000000",
        "amount": "0.0001",
        "gas_asset": "ETH"
      },
      "fees": [
        {
          "type": "privy",
          "recipient": "0x1234567890abcdef1234567890abcdef12345678",
          "amount": "0.20"
        }
      ],
      "gas": {
        "base_amount": "100000000000000",
        "amount": "0.0001",
        "gas_asset": "ETH"
      }
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

privy-app-id
string
required

ID of your Privy app.

privy-authorization-signature
string

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

Path Parameters

wallet_id
string
required

ID of the wallet.

Query Parameters

cursor
string
Minimum string length: 1
limit
number | null
Required range: x <= 100
type
enum<string>

Type of wallet action

Available options:
swap,
transfer,
earn_deposit,
earn_withdraw,
earn_incentive_claim

Response

200 - application/json

Paginated list of wallet actions.

Paginated list of wallet actions.

data
(SwapActionResponse · object | TransferActionResponse · object | EarnDepositActionResponse · object | EarnWithdrawActionResponse · object | EarnIncentiveClaimActionResponse · object)[]
required

Response for a swap action.

next_cursor
string | null
required