> ## Documentation Index
> Fetch the complete documentation index at: https://docs.privy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get transactions

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



## OpenAPI

````yaml get /v1/wallets/{wallet_id}/transactions
openapi: 3.1.0
info:
  version: 0.0.1
  title: Privy API
  description: >-
    REST API for Privy's wallet infrastructure — provision and manage wallets
    across EVM, Solana, and Bitcoin, authenticate users, sign transactions, and
    configure programmable policies and authorization intents.
  contact:
    name: Privy
    url: https://www.privy.io/
    email: support@privy.io
servers:
  - url: https://api.privy.io
security: []
tags:
  - name: Accounts
    description: Operations related to asset accounts
  - name: Aggregations
    description: Operations related to aggregations for tracking and measuring metrics
  - name: Apps
    description: Operations related to app settings and allowlist management
  - name: Client Auth
    description: OAuth token exchange and device authorization operations
  - name: Condition Sets
    description: Operations related to condition sets
  - name: Embedded wallets
    description: Operations related to embedded wallet creation and authentication
  - name: Fiat
    description: Operations related to fiat onramping and offramping
  - name: Intents
    description: Operations related to authorization intents for wallet actions
  - name: Key quorums
    description: Operations related to key quorums
  - name: Kraken Embed
    description: >-
      Operations for Kraken Embed integration, including quotes, trades, user
      management, and portfolio operations
  - name: OAuth
    description: >-
      OAuth 2.0 endpoints including Device Authorization Grant (RFC 8628) for
      CLI and limited-input device login flows
  - name: Organizations
    description: Operations related to organization secret management
  - name: Policies
    description: Operations related to policies
  - name: Shared
    description: Common schemas shared across resources
  - name: Swaps
    description: Operations for swapping tokens within wallets
  - name: Transactions
    description: Operations related to transactions
  - name: User signers
    description: Operations related to user signers
  - name: Users
    description: Operations related to users
  - name: Wallet Actions
    description: Operations related to wallet actions
  - name: Wallets
    description: Operations related to wallets
  - name: Webhooks
    description: >-
      Webhook events that Privy sends to your configured endpoint when specific
      actions occur in your app
  - name: Yield
    description: >-
      Operations for depositing and withdrawing funds from ERC-4626 yield vaults
      (Morpho, Aave)
paths:
  /v1/wallets/{wallet_id}/transactions:
    get:
      tags:
        - Wallets
      summary: Get transactions
      description: Get incoming and outgoing transactions of a wallet by wallet ID.
      operationId: getWalletTransactions
      parameters:
        - schema:
            type: string
            description: ID of the wallet.
          required: true
          name: wallet_id
          in: path
        - schema:
            type: string
            minLength: 1
          required: false
          name: cursor
          in: query
        - schema:
            type:
              - number
              - 'null'
            maximum: 100
          required: false
          name: limit
          in: query
        - schema:
            $ref: '#/components/schemas/TransactionChainNameInput'
          required: true
          name: chain
          in: query
        - schema:
            anyOf:
              - $ref: '#/components/schemas/WalletEthereumAsset'
              - $ref: '#/components/schemas/WalletSolanaAsset'
              - $ref: '#/components/schemas/WalletTronAsset'
              - type: array
                items:
                  $ref: '#/components/schemas/WalletAsset'
                maxItems: 10
            description: >-
              Exactly one of `asset` or `token` is required. Cannot be used
              together with `token`.
          required: false
          name: asset
          in: query
        - schema:
            anyOf:
              - $ref: '#/components/schemas/TransactionTokenAddressInput'
              - type: array
                items:
                  $ref: '#/components/schemas/TransactionTokenAddressInput'
                maxItems: 10
            description: >-
              Exactly one of `token` or `asset` is required. Cannot be used
              together with `asset`.
          required: false
          name: token
          in: query
        - schema:
            type: string
          required: false
          name: tx_hash
          in: query
        - schema:
            type: boolean
            description: Include archived wallets in lookup. Defaults to false.
          required: false
          name: include_archived
          in: query
        - schema:
            type: string
            description: ID of your Privy app.
          required: true
          name: privy-app-id
          in: header
      responses:
        '200':
          description: Latest wallet transactions.
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactions:
                    type: array
                    items:
                      type: object
                      properties:
                        caip2:
                          type: string
                        transaction_hash:
                          type:
                            - string
                            - 'null'
                        user_operation_hash:
                          type: string
                        status:
                          $ref: '#/components/schemas/BlockchainTransactionStatus'
                        created_at:
                          type: number
                        sponsored:
                          type: boolean
                        details:
                          allOf:
                            - $ref: '#/components/schemas/TransactionDetail'
                            - oneOf:
                                - $ref: >-
                                    #/components/schemas/TransferSentTransactionDetail
                                - $ref: >-
                                    #/components/schemas/TransferReceivedTransactionDetail
                                - type: 'null'
                        privy_transaction_id:
                          type: string
                        wallet_id:
                          type: string
                      required:
                        - caip2
                        - transaction_hash
                        - status
                        - created_at
                        - details
                        - privy_transaction_id
                        - wallet_id
                  next_cursor:
                    type:
                      - string
                      - 'null'
                required:
                  - transactions
                  - next_cursor
              example:
                transactions:
                  - caip2: eip155:8453
                    transaction_hash: >-
                      0x03fe1b0fd11a74d277a5b7a68b762de906503b82cbce2fc791250fd2b77cf137
                    status: confirmed
                    created_at: 1746920539240
                    privy_transaction_id: au6wxoyhbw4yhwbn1s5v9gs9
                    wallet_id: xs76o3pi0v5syd62ui1wmijw
                    details:
                      type: transfer_sent
                      chain: base
                      asset: eth
                      sender: '0xa24c8d74c913e5dba36e45236c478f37c8bba20e'
                      sender_privy_user_id: rkiz0ivz254drv1xw982v3jq
                      recipient: '0x38bc05d7b69f63d05337829fa5dc4896f179b5fa'
                      recipient_privy_user_id: cmakymbpt000te63uaj85d9r6
                      raw_value: '1'
                      raw_value_decimals: 18
                      display_values:
                        eth: '0.000000000000000001'
                next_cursor: null
      security:
        - appSecretAuth: []
components:
  schemas:
    TransactionChainNameInput:
      type: string
      enum:
        - ethereum
        - arbitrum
        - avalanche
        - base
        - bsc
        - tempo
        - linea
        - optimism
        - polygon
        - solana
        - sepolia
      description: Chains supported for transaction history queries.
      title: TransactionChainNameInput
      x-stainless-model: wallets.transaction_chain_name_input
    WalletEthereumAsset:
      type: string
      enum:
        - usdc
        - usdc.e
        - eth
        - avax
        - pol
        - bnb
        - usdt
        - eurc
        - usdb
      description: A named asset on Ethereum-compatible chains.
      title: WalletEthereumAsset
      x-stainless-model: wallets.wallet_ethereum_asset
    WalletSolanaAsset:
      type: string
      enum:
        - sol
        - usdc
        - eurc
        - usdb
      description: A named asset on Solana.
      title: WalletSolanaAsset
      x-stainless-model: wallets.wallet_solana_asset
    WalletTronAsset:
      type: string
      enum:
        - trx
        - usdt
        - usdc
      description: A named asset on Tron.
      title: WalletTronAsset
      x-stainless-model: wallets.wallet_tron_asset
    WalletAsset:
      anyOf:
        - $ref: '#/components/schemas/WalletEthereumAsset'
        - $ref: '#/components/schemas/WalletSolanaAsset'
        - $ref: '#/components/schemas/WalletTronAsset'
      description: A named asset supported across all chains.
      title: WalletAsset
      x-stainless-model: wallets.wallet_asset
    TransactionTokenAddressInput:
      type: string
      description: >-
        Token contract address (EVM: 0x-prefixed hex) or mint address (Solana:
        base58), used to filter wallet transactions.
      title: TransactionTokenAddressInput
      x-stainless-model: wallets.transaction_token_address_input
    BlockchainTransactionStatus:
      type: string
      enum:
        - broadcasted
        - confirmed
        - execution_reverted
        - failed
        - replaced
        - finalized
        - provider_error
        - pending
      description: Status of a blockchain transaction submitted by Privy.
      title: BlockchainTransactionStatus
      x-stainless-model: transactions.blockchain_transaction_status
    TransactionDetail:
      oneOf:
        - $ref: '#/components/schemas/TransferSentTransactionDetail'
        - $ref: '#/components/schemas/TransferReceivedTransactionDetail'
      discriminator:
        propertyName: type
        mapping:
          transfer_sent:
            $ref: '#/components/schemas/TransferSentTransactionDetail'
          transfer_received:
            $ref: '#/components/schemas/TransferReceivedTransactionDetail'
      description: Details of a wallet transaction, varying by transaction type.
      title: TransactionDetail
      x-stainless-model: wallets.transaction_detail
    TransferSentTransactionDetail:
      type: object
      properties:
        type:
          type: string
          enum:
            - transfer_sent
        sender:
          type: string
        sender_privy_user_id:
          type:
            - string
            - 'null'
        recipient:
          type: string
        recipient_privy_user_id:
          type:
            - string
            - 'null'
        chain:
          $ref: '#/components/schemas/WalletAssetChainNameInput'
        asset:
          anyOf:
            - $ref: '#/components/schemas/WalletEthereumAsset'
            - $ref: '#/components/schemas/WalletSolanaAsset'
            - $ref: '#/components/schemas/WalletTronAsset'
            - type: string
        raw_value:
          type: string
        raw_value_decimals:
          type: number
        display_values:
          type: object
          additionalProperties:
            type: string
      required:
        - type
        - sender
        - sender_privy_user_id
        - recipient
        - recipient_privy_user_id
        - chain
        - asset
        - raw_value
        - raw_value_decimals
        - display_values
      description: Details for a sent transfer transaction.
      title: TransferSentTransactionDetail
      x-stainless-model: wallets.transfer_sent_transaction_detail
    TransferReceivedTransactionDetail:
      type: object
      properties:
        type:
          type: string
          enum:
            - transfer_received
        sender:
          type: string
        sender_privy_user_id:
          type:
            - string
            - 'null'
        recipient:
          type: string
        recipient_privy_user_id:
          type:
            - string
            - 'null'
        chain:
          $ref: '#/components/schemas/WalletAssetChainNameInput'
        asset:
          anyOf:
            - $ref: '#/components/schemas/WalletEthereumAsset'
            - $ref: '#/components/schemas/WalletSolanaAsset'
            - $ref: '#/components/schemas/WalletTronAsset'
            - type: string
        raw_value:
          type: string
        raw_value_decimals:
          type: number
        display_values:
          type: object
          additionalProperties:
            type: string
      required:
        - type
        - sender
        - sender_privy_user_id
        - recipient
        - recipient_privy_user_id
        - chain
        - asset
        - raw_value
        - raw_value_decimals
        - display_values
      description: Details for a received transfer transaction.
      title: TransferReceivedTransactionDetail
      x-stainless-model: wallets.transfer_received_transaction_detail
    WalletAssetChainNameInput:
      type: string
      enum:
        - 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
      description: >-
        Supported blockchain network names for wallet balance and transaction
        queries.
      title: WalletAssetChainNameInput
      x-stainless-model: wallets.wallet_asset_chain_name_input
  securitySchemes:
    appSecretAuth:
      type: http
      scheme: basic
      description: >-
        Basic Auth header with your app ID as the username and your app secret
        as the password.

````