---
title: "Get transactions"
method: GET
path: "/v1/wallets/{wallet_id}/transactions"
tags: ["Wallets"]
---

# Get transactions

`GET /v1/wallets/{wallet_id}/transactions`

Get incoming and outgoing transactions of a wallet by wallet ID.

## Path parameters

- `wallet_id` string, required — ID of the wallet.

## Query parameters

- `cursor` string
- `limit` number, nullable
- `chain` 'ethereum' | 'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'tempo' | 'linea' | 'optimism' | 'polygon' | 'solana' | 'sepolia', required — Chains supported for transaction history queries.
- `asset` union — Exactly one of `asset` or `token` is required. Cannot be used together with `token`.
  - 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'bnb' | 'usdt' | 'eurc' | 'usdb' — A named asset on Ethereum-compatible chains.
  - 'sol' | 'usdc' | 'eurc' | 'usdb' — A named asset on Solana.
  - 'trx' | 'usdt' | 'usdc' — A named asset on Tron.
  - WalletAsset[]
    - union — A named asset supported across all chains.
      - 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'bnb' | 'usdt' | 'eurc' | 'usdb' — A named asset on Ethereum-compatible chains.
      - 'sol' | 'usdc' | 'eurc' | 'usdb' — A named asset on Solana.
      - 'trx' | 'usdt' | 'usdc' — A named asset on Tron.
- `token` union — Exactly one of `token` or `asset` is required. Cannot be used together with `asset`.
  - string — Token contract address (EVM: 0x-prefixed hex) or mint address (Solana: base58), used to filter wallet transactions.
  - TransactionTokenAddressInput[]
- `tx_hash` string
- `include_archived` boolean — Include archived wallets in lookup. Defaults to false.

## Headers

- `privy-app-id` string, required — ID of your Privy app.

## Response `200`

Latest wallet transactions.

- object
  - `next_cursor` string, nullable, required
  - `transactions` object[], required
    - `caip2` string, required
    - `created_at` number, required
    - `details` union, required
      - TransferSentTransactionDetail — Details for a sent transfer transaction.
        - `asset` union, required
          - 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'bnb' | 'usdt' | 'eurc' | 'usdb' — A named asset on Ethereum-compatible chains.
          - 'sol' | 'usdc' | 'eurc' | 'usdb' — A named asset on Solana.
          - 'trx' | 'usdt' | 'usdc' — A named asset on Tron.
          - string
        - `chain` 'ethereum' | 'arbitrum' | 'avalanche' | 'base' | 'tempo' | 'linea' | 'optimism' | 'polygon' | 'bsc' | 'solana' | 'tron' | 'zksync_era' | 'sepolia' | 'arbitrum_sepolia' | 'avalanche_fuji' | 'base_sepolia' | 'linea_testnet' | 'optimism_sepolia' | 'polygon_amoy' | 'solana_devnet' | 'solana_testnet' | 'tron_nile', required — Supported blockchain network names for wallet balance and transaction queries.
        - `display_values` object, required
        - `raw_value` string, required
        - `raw_value_decimals` number, required
        - `recipient` string, required
        - `recipient_privy_user_id` string, nullable, required
        - `sender` string, required
        - `sender_privy_user_id` string, nullable, required
        - `type` 'transfer_sent', required
      - TransferReceivedTransactionDetail — Details for a received transfer transaction.
        - `asset` union, required
          - 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'bnb' | 'usdt' | 'eurc' | 'usdb' — A named asset on Ethereum-compatible chains.
          - 'sol' | 'usdc' | 'eurc' | 'usdb' — A named asset on Solana.
          - 'trx' | 'usdt' | 'usdc' — A named asset on Tron.
          - string
        - `chain` 'ethereum' | 'arbitrum' | 'avalanche' | 'base' | 'tempo' | 'linea' | 'optimism' | 'polygon' | 'bsc' | 'solana' | 'tron' | 'zksync_era' | 'sepolia' | 'arbitrum_sepolia' | 'avalanche_fuji' | 'base_sepolia' | 'linea_testnet' | 'optimism_sepolia' | 'polygon_amoy' | 'solana_devnet' | 'solana_testnet' | 'tron_nile', required — Supported blockchain network names for wallet balance and transaction queries.
        - `display_values` object, required
        - `raw_value` string, required
        - `raw_value_decimals` number, required
        - `recipient` string, required
        - `recipient_privy_user_id` string, nullable, required
        - `sender` string, required
        - `sender_privy_user_id` string, nullable, required
        - `type` 'transfer_received', required
    - `privy_transaction_id` string, required
    - `sponsored` boolean
    - `status` 'broadcasted' | 'confirmed' | 'execution_reverted' | 'failed' | 'replaced' | 'finalized' | 'provider_error' | 'pending', required — Status of a blockchain transaction submitted by Privy.
    - `transaction_hash` string, nullable, required
    - `user_operation_hash` string
    - `wallet_id` string, required

## Changes

- **2026-07-07** `fe716f5dc618` — 2 info
  - added the new enum value `avalanche` to the `query` request parameter `chain`
  - added the new enum value `bsc` to the `query` request parameter `chain`
- **2026-07-02** `21829d464e9b` — 16 warning, 6 info
  - added the new `bnb` enum value to the `transactions/items/details/allOf[subschema #1: TransactionDetail]/oneOf[subschema #1: TransferSentTransactionDetail]/asset/anyOf[subschema #1: WalletEthereumAsset]/` response property for the response status `200`
  - added the new `bnb` enum value to the `transactions/items/details/allOf[subschema #1: TransactionDetail]/oneOf[subschema #2: TransferReceivedTransactionDetail]/asset/anyOf[subschema #1: WalletEthereumAsset]/` response property for the response status `200`
  - added the new `bnb` enum value to the `transactions/items/details/allOf[subschema #2]/oneOf[subschema #1: TransferSentTransactionDetail]/asset/anyOf[subschema #1: WalletEthereumAsset]/` response property for the response status `200`
  - added the new `bnb` enum value to the `transactions/items/details/allOf[subschema #2]/oneOf[subschema #2: TransferReceivedTransactionDetail]/asset/anyOf[subschema #1: WalletEthereumAsset]/` response property for the response status `200`
  - …18 more
- **2026-06-12** `41cbc1e43b72` — 1 info
  - added the new optional `query` request parameter `include_archived`
- …earlier changes not shown

[Full history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/wallets/:wallet_id/transactions/get.md)

---

[API](https://skmtc.dev/privy-io/apis/privy-api.md) · [All operations](https://skmtc.dev/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)