Fetch paginated transaction history for an embedded wallet with the Swift and Android SDKs
Privy’s Swift and Android SDKs let an app fetch the transaction history for an embedded Ethereum or
Solana wallet, with support for filtering by asset, token, or transaction hash, and paginating
through results.
Only TEE wallets support fetching transaction history. Calling getTransactions on a wallet that
isn’t a TEE wallet returns an error.
Use the getTransactions method on an embedded wallet to fetch its paginated transaction history.
You must provide either assets or tokens. They are mutually exclusive — do not pass both.
GetTransactionsParams
required
The filters and pagination options for the transaction history request.
Hide child attributes
TransactionChain
required
The chain to fetch transactions for, e.g. .base, .ethereum, .solana, or
.custom(chainSlug) for other supported chains.
[String]?
required
Filter by named asset, e.g. ["eth"] or ["ousd"]. Required if tokens is not
provided. Mutually exclusive with tokens.
[String]?
required
Filter by token contract address (EVM) or mint address (Solana). Required if assets
is not provided. Mutually exclusive with assets.
String?
Filter to a single transaction by its hash. EVM hashes are 0x-prefixed 64 hex
characters; Solana hashes are 87-88 base58 characters.
Int?
The maximum number of transactions to return in this page.
String?
A pagination cursor from a previous TransactionsPage.nextCursor, used to fetch the
next page of results.
Bool?
Whether to include transactions from archived wallets. Defaults to false.
Returns
TransactionsPage
The requested page of transaction history.
Hide child attributes
[WalletTransaction]
The transactions in this page.
Show child attributes
String
The CAIP-2 chain ID for the network the transaction was broadcasted on, e.g. eip155:8453.
String?
The hash of the transaction, if it has been broadcasted.
String?
The ERC-4337 user operation hash, for smart-contract wallets only.
TransactionStatus
The current status of the transaction: .broadcasted, .confirmed,
.executionReverted, .failed, .replaced, .finalized, .providerError,
.pending, or .unknown(rawValue).
Int
The creation time of the transaction, in milliseconds since the Unix epoch.
Bool
Whether gas for the transaction was sponsored.
String?
Privy’s internal ID for the transaction, if available.
String
The ID of the wallet that sent the transaction.
TransactionDetails?
Additional details about the transaction, present for transfer transactions.
Show child attributes
TransactionType
.transferSent, .transferReceived, or .unknown(rawValue).
String
The address that sent the transaction.
String?
The Privy user ID for the sender, if known.
String
The address that received the transaction.
String?
The Privy user ID for the recipient, if known.
String
The chain the transaction occurred on.
String
The asset transferred, e.g. "eth" or a token contract/mint address.
String
The raw transferred amount, as a string to avoid floating-point precision loss.
Int
The number of decimals for rawValue.
[String: String]
Formatted, human-readable amounts for the transfer.
String?
A cursor for fetching the next page of results. nil if there are no more results.
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.