---
title: "Get Wallet Transactions"
method: GET
path: "/v1/wallets/{address}/transactions"
tags: ["Gateway"]
---

# Get Wallet Transactions

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

Retrieves transactions for a specific wallet address across one or more blockchain networks. This endpoint provides comprehensive transaction data including both incoming and outgoing transactions, with block information, gas details, transaction status, and function calls. Results can be filtered, paginated, and sorted to meet specific requirements.

**Authentication**: Pass `x-client-id` header for frontend usage from allowlisted origins or `x-secret-key` for backend usage.

## Path parameters

- `address` string, required — A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).

## Query parameters

- `chainId` integer[], required — Chain ID(s) to request transaction data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137
- `filterBlockTimestampGte` integer, nullable — Filter by block timestamp (Unix timestamp) greater than or equal to this value
- `filterBlockTimestampLte` integer, nullable — Filter by block timestamp (Unix timestamp) less than or equal to this value
- `filterBlockNumberGte` integer, nullable — Filter by block number greater than or equal to this value
- `filterBlockNumberLte` integer, nullable — Filter by block number less than or equal to this value
- `filterValueGt` string — Filter by transaction value (in wei) greater than this value
- `filterFunctionSelector` string — Filter by function selector (4-byte method ID), e.g., '0xa9059cbb' for ERC-20 transfer
- `page` number, nullable — Current page number
- `limit` number, nullable — Number of items per page
- `sortOrder` 'asc' | 'desc' — Sort order: 'asc' for ascending, 'desc' for descending

## Response `200`

Wallet transactions retrieved successfully. Returns transaction data with metadata including pagination information and chain details. Includes decoded function calls when ABI is available.

- object
  - `result` object, required
    - `pagination` object, required
      - `hasMore` boolean — Whether there are more items available
      - `limit` number, nullable — Number of items per page
      - `page` number, nullable — Current page number
      - `totalCount` number, nullable — Total number of items available
    - `transactions` object[], required — Array of wallet transactions.
      - `blockHash` string, required — The hash of the block containing this transaction.
      - `blockNumber` number, required — The block number containing this transaction.
      - `blockTimestamp` number, required — The timestamp of the block (Unix timestamp).
      - `chainId` string, required — The chain ID where the transaction occurred.
      - `contractAddress` string — Contract address created if this was a contract creation transaction.
      - `cumulativeGasUsed` number — Total gas used by all transactions in this block up to and including this one.
      - `data` string, required — The transaction input data.
      - `decoded` object — Decoded transaction data (included when ABI is available).
        - `inputs` object, required — Object containing decoded function parameters.
        - `name` string, required — The function name.
        - `signature` string, required — The function signature.
      - `effectiveGasPrice` string — The effective gas price paid (in wei as string).
      - `fromAddress` string, required — The address that initiated the transaction.
      - `functionSelector` string, required — The function selector (first 4 bytes of the transaction data).
      - `gas` number, required — The gas limit for the transaction.
      - `gasPrice` string, required — The gas price used for the transaction (in wei as string).
      - `gasUsed` number — The amount of gas used by the transaction.
      - `hash` string, required — The transaction hash.
      - `maxFeePerGas` string — Maximum fee per gas (EIP-1559).
      - `maxPriorityFeePerGas` string — Maximum priority fee per gas (EIP-1559).
      - `nonce` number, required — The transaction nonce.
      - `status` number, required — The transaction status (1 for success, 0 for failure).
      - `toAddress` string, required — The address that received the transaction.
      - `transactionIndex` number, required — The index of the transaction within the block.
      - `transactionType` number — The transaction type (0=legacy, 1=EIP-2930, 2=EIP-1559).
      - `value` string, required — The value transferred in the transaction (in wei as string).

## Other responses

- `400` — Invalid request parameters. This occurs when the wallet address format is invalid, chainId array is empty or exceeds the maximum limit of 50, or pagination parameters are out of range.
- `401` — Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage.
- `404` — Wallet not found or no transactions available for the specified wallet address on the given blockchain networks.
- `500` — Internal server error. This may occur due to network connectivity issues, external service unavailability, or unexpected server errors.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/revisions/fb4cb67da1c7/schema)