> ## Documentation Index > Fetch the complete documentation index at: https://docs.amberdata.io/llms.txt > Use this file to discover all available pages before exploring further. # Transactions - By Wallet Address > Retrieves the confirmed transactions where this address was either the originator or a recipient. Currently supported on `ethereum-mainnet` only. Note that transactions are returned in descending order by default (block number and transaction index), which means the most recent transactions are on page 0, and the oldest transactions are on the last page. If you intend to traverse all the transactions, it is recommended to specify the flag `direction=ascending`, which will guarantee that the pagination is stable and will not change with the arrival of new transactions. **Filtering:** when `blockNumber` is supplied it takes precedence over `startDate`/`endDate`. A `[startDate, endDate)` window is capped at 90 days; supplying only one bound fills the other in (missing `endDate` → now, missing `startDate` → `endDate` − 30 days). Supplying neither returns the most recent transactions with no time bound. **Unsupported parameters:** `from`, `to`, `includeLogs`, `includeTokenTransfers`, `includePrice` and `validationMethod` are not supported on this endpoint and are rejected with a `400`. ## OpenAPI ````yaml get /addresses/{hash}/transactions openapi: 3.1.0 info: title: blockchain-api version: '2' servers: - url: https://api.amberdata.com/blockchains security: - sec0: [] paths: /addresses/{hash}/transactions: get: summary: Transactions - By Wallet Address description: >- Retrieves the confirmed transactions where this address was either the originator or a recipient. Currently supported on `ethereum-mainnet` only. Note that transactions are returned in descending order by default (block number and transaction index), which means the most recent transactions are on page 0, and the oldest transactions are on the last page. If you intend to traverse all the transactions, it is recommended to specify the flag `direction=ascending`, which will guarantee that the pagination is stable and will not change with the arrival of new transactions. **Filtering:** when `blockNumber` is supplied it takes precedence over `startDate`/`endDate`. A `[startDate, endDate)` window is capped at 90 days; supplying only one bound fills the other in (missing `endDate` → now, missing `startDate` → `endDate` − 30 days). Supplying neither returns the most recent transactions with no time bound. **Unsupported parameters:** `from`, `to`, `includeLogs`, `includeTokenTransfers`, `includePrice` and `validationMethod` are not supported on this endpoint and are rejected with a `400`. operationId: get-address-transactions parameters: - name: hash in: path description: address to retrieve transactions for schema: type: string default: '0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB' required: true - name: blockchain in: query description: The blockchain to query. Only `ethereum-mainnet` is supported. schema: type: string enum: - ethereum-mainnet default: ethereum-mainnet - name: blockNumber in: query description: >- Filter by transactions for this block number. Takes precedence over `startDate`/`endDate` when supplied. schema: type: integer format: int64 - name: startDate in: query description: >- Filter by transactions which happened at or after this date (inclusive). Accepts RFC3339 (`2024-01-01T00:00:00Z`), `YYYY-MM-DD`, or a numeric timestamp in milliseconds/seconds. Ignored when `blockNumber` is set. schema: type: string format: date-time - name: endDate in: query description: >- Filter by transactions which happened before this date (exclusive). Accepts RFC3339 (`2024-01-01T00:00:00Z`), `YYYY-MM-DD`, or a numeric timestamp in milliseconds/seconds. The `[startDate, endDate)` window is capped at 90 days. Ignored when `blockNumber` is set. schema: type: string format: date-time - name: decodeTransactions in: query description: >- Decodes the transaction `input` via known ABIs and adds a `decodedTransactionInput` object to each record where the ABI could be resolved. schema: type: boolean default: false - name: direction in: query description: >- The order in which to return the results (ascending or descending). By default, records are returned in descending order, so the most recent records are returned first. schema: type: string enum: - ascending - descending default: descending - name: timeFormat in: query description: >- The format in which to return the `timestamp` field: `iso` and `hr` return a string, `ms` and `ns` return a number. schema: type: string enum: - iso - hr - ms - ns default: iso - name: page in: query description: The page number to return. schema: type: integer format: int32 default: 0 - name: size in: query description: The number of records per page (maximum 1000) schema: type: integer format: int32 default: 100 - name: x-amberdata-blockchain-id in: header description: The id of the blockchain schema: type: string enum: - ethereum-mainnet default: ethereum-mainnet responses: '200': description: '200' content: application/json: schema: type: object properties: status: type: integer example: 200 default: 0 title: type: string example: OK description: type: string example: Successful request payload: type: object properties: records: type: array items: type: object properties: blockHash: type: string example: >- 0x3d7b4a0779ed4a6d1a19b21765355bfc730d61b40738572bbc142b80f20b42cd blockNumber: type: string example: '25625395' confirmations: type: string example: '694' contractAddress: type: string description: >- The contract created by this transaction, or the literal string `"null"` when the transaction did not create a contract. example: 'null' cumulativeGasUsed: type: string example: '6462265' decodedTransactionInput: type: object description: >- Only present when `decodeTransactions=true` and the ABI for the called contract could be resolved. properties: name: type: string example: transferPunk signature: type: string example: transferPunk(address,uint256) sighash: type: string example: '0x8b72a2ec' args: type: array items: {} example: - '0xB88F61E6FbdA83fbfffAbE364112137480398018' - '4710' value: type: string example: '0' fee: type: string example: '109520871298860' from: type: array items: type: object properties: address: type: string example: '0x089f31c6cc14eff1229dd56d015c59cb3c7e6c5a' nameNormalized: type: string description: >- Display name for a known token/contract address. Omitted when the address has no known name. example: CRYPTOPUNKS gasLimit: type: string example: '73017' gasPrice: type: string example: '2267935460' gasUsed: type: string example: '48291' hash: type: string example: >- 0x1e6297457c56afab7850b5881b38b11ac64a85b351b752c8d335d930a81a1347 index: type: integer example: 111 default: 0 input: type: string example: 0x8b72a2ec0... logsBloom: type: string example: 0x000000... maxFeePerGas: type: - string - 'null' description: >- EIP-1559 field. `null` for pre-EIP-1559 (legacy / access-list) transactions. example: '2394781618' maxPriorityFeePerGas: type: - string - 'null' description: >- EIP-1559 field. `null` for pre-EIP-1559 (legacy / access-list) transactions. example: '2000000000' nonce: type: string example: '265' publicKey: type: string example: '' r: type: string example: >- 0x525d3cf345f681b3aeda8ec9ca1db919b7187f62ad51d2e40a74eef67822314b raw: type: string example: '' root: type: string example: '' s: type: string example: >- 0x608bb26ecf389fa15f4ff162e20512eb299991e06ce28ab12fc3d5ad9ddb08f status: type: string example: '0x1' timestamp: description: >- Rendered per the `timeFormat` parameter: an ISO string for `iso` (default), a human-readable string for `hr`, and a number for `ms` / `ns`. example: '2026-07-27T16:39:23.000Z' to: type: array items: type: object properties: address: type: string example: '0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb' nameNormalized: type: string description: >- Display name for a known token/contract address. Omitted when the address has no known name. example: CRYPTOPUNKS type: type: integer description: >- EIP-2718 transaction type: 0 legacy, 1 access-list, 2 dynamic-fee, 3 blob, 4 set-code. example: 2 default: 0 v: type: string example: '1' value: type: string example: '0' statusResult: type: object properties: code: type: string example: '0x1' confirmed: type: boolean example: true default: true success: type: boolean example: true default: true name: type: string example: successful '400': description: '400' content: application/json: schema: type: object properties: status: type: integer example: 400 default: 0 title: type: string example: BAD REQUEST description: type: string example: >- Request was invalid or cannot be served. See message for details error: type: boolean example: true default: true message: type: string example: startDate/endDate window exceeds the 90-day limit deprecated: false security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ````