getWalletTransactions

Get all incoming and outgoing transactions for the given wallet address in reverse chronological order (most recent first)

Explore how to efficiently retrieve a comprehensive transaction history for a specific wallet address using the 'getWalletTransactions' API method. Transactions are conveniently presented in reverse chronological order, showcasing the most recent transactions first. This API provides valuable insights into both incoming and outgoing wallet activity, empowering you to effectively track and manage transaction history.

How to use getWalletTransactions method ?

Below, you'll find an in-depth guide that provides a comprehensive explanation of how to utilize the getWalletTransactions method effectively using Blast Builder API.

Field	Type	Description
walletAddress	string	The address of the wallet
fromBlock	string	Indicate the starting block from which to get the transactions
toBlock	string	Indicate ending block up to which to get the transactions
secondWalletAddress	string	Filter transactions involving the given wallet address and a second address
onlyIncoming	boolean	Return only incoming transfers. Default is false. If set to true, only incoming transactions are included. If set to true, onlyOutgoing must be false.
onlyOutgoing	boolean	Return only outgoing transfers. Default is false. If set to true, only outgoing transactions are included. If set to true, onlyIncoming must be false.
pageSize	integer	Number of records to be retrieved on one page
pageKey	string	Key used to get the next page of results. Must be set to the value of nextPageKey returned in the previous response

Returns

In this section, you can find detailed information about the parameters returned by the getWalletTransactions method, which offer insights into wallet transactions on the blockchain. These parameters encompass transaction details like transaction hashes, block information, sender and receiver addresses, gas-related data, transaction status, and more. Developers can leverage these parameters to gain a comprehensive understanding of a wallet's transaction history and execute various analyses or operations based on this valuable data.

Field	Type	Description
walletAddress	string	The wallet address of the holder
count	integer	The number of transactions
nextPageKey	string	Key to get the next page of results, if more results are available
transactions	array	Array of Transaction objects
transactionHash	string	The hash of the transaction
transactionIndex	integer	The index of the transaction
blockHash	string	The hash of the block containing the transaction
blockNumber	integer	The height of the block containing the transaction
blockTimestamp	string	The timestamp of the block in which the transfer transaction was executed
fromAddress	string	The address executing the transaction
toAddress	string	The address on the receiving end of the transaction
nonce	integer	The number of transactions sent from the sender address
minerAddress	string	The address of the validator that mined the block
gasLimit	string	The maximum amount of gas you set for the transaction
gasPrice	string	Price offered for each unit of gas used in the transaction, denoted in wei
maxGasPrice	string	(optional, for type 2 transactions only) Absolute maximum price willing to pay for each unit of gas used in the transaction, including priority fee, as per EIP-1559, denoted in wei
maxPriorityGasPrice	string	(optional, for type 2 transactions only) Maximum priority fee price willing to pay for each unit of gas used in the transaction, as per EIP-1559, denoted in wei
effectiveGasPrice	string	Actual price paid for each unit of gas used in the transaction, denoted in wei
transactionFee	string	Total amount paid for processing the transaction, denoted in wei
gasUsed	string	The total amount paid for the transaction, a multiplication product of gasLimit and gasPrice
value	string	The value being transacted
l1GasInfo	Arbitrum	L1 gas and fee information
gasUsedForL1	string	The amount of gas used on L1 in units of L2 gas
l1Fee	string	Fee paid on L1 to post the transaction, denoted in wei
l1GasInfo	Base, Optimism	L1 gas and fee information
l1GasUsed	string	The amount of gas used on L1
l1GasPrice	string	Price paid for each unit of L1 gas, denoted in wei
l1FeeScalar	string	L1 fee scalar
l1Fee	string	Fee paid on L1 to post the transaction, denoted in wei
contractAddress	string	The address of the contract
input	string	Additional data included for this transaction
status	integer	The status for the transaction
type	integer	The type of the transaction

Example Request and Result for getWalletTransactions

In this section, we present an illustrative example of a request made using the 'getWalletTransactions' API method, along with a detailed breakdown of the resulting data. This example serves as a practical reference to demonstrate how to retrieve wallet transaction informations, helping you understand and utilize the API effectively.

The example in this section uses a non-existing project id.

Make sure you replace it with your Starknet endpoint when issuing the Builder API calls.

Don't have a project id? Here's a straightforward guide on how to obtain one!

GET https://starknet-mainnet.blastapi.io/<project-id>/builder/getWalletTransactions?

Query Parameters

Name	Type	Description
walletAddress	String	0x069e5becf53bed3a73c3ebaaeb3deee49fd9fc1da31f9be3b3e34d761cd630ee
fromBlock	String	18375873
pageSize	String	10
toBlock	String	18375873

200: OK Expand for a detailed response example

{
    "wallet_address": "0x6ba5dd023815104325a7d6eae98a259f6ab44deb",
    "count": 1,
    "transactions": [{
        "transactionHash": "0xf3b81285e4a638fc5d8a93b0e3b572da3035969b52f514300c7af01fe8aeb878",
        "transactionIndex": 98,
        "blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
        "blockNumber": 18375873,
        "blockTimestamp": "2023-10-18T07:51:59.000Z",
        "fromAddress": "0x6ba5dd023815104325a7d6eae98a259f6ab44deb",
        "toAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "nonce": 36,
        "minerAddress": "0x388c818ca8b9251b393131c08a736a67ccb19297",
        "gasLimit": "69163",
        "gasPrice": "6315248398",
        "gasUsed": "46109",
        "value": "0",
        "contractAddress": null,
        "input": "0xa9059cbb000000000000000000000000369986e70ffba1d2062a402c76dcb2d0ed35c346000000000000000000000000000000000000000000000000000000003689cac0",
        "status": 1,
        "type": 2
    }]
}

Curl request example

curl --location 'https://eth-mainnet.blastapi.io/<project-id>/builder/getWalletTransactions?walletAddress=0x6Ba5DD023815104325a7d6EAE98A259f6ab44dEb&pageSize=10&fromBlock=18375873&toBlock=18375873'