Links

getWalletTransactions

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

Parameters

  • walletAddress :(string) REQUIRED - The address of the wallet
  • fromBlock : (string) OPTIONAL - Indicate the starting block from which to get the transactions
  • toBlock : (string) OPTIONAL - Indicate ending block up to which to get the transactions
  • secondWalletAddress : (string) OPTIONAL -Filter transactions involving the given wallet address and a second address
  • onlyIncoming : (boolean) OPTIONAL - Return only incoming transfers
  • onlyOutgoing : (boolean) OPTIONAL - Return only outgoing transfers
  • pageSize : (integer) OPTIONAL - Number of records to be retrieved on one page
  • pageKey : (string) OPTIONAL - Key used to get the next page of results. Must be set to the value of nextPageKey returned in the previous response

Returns

  • 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> - The price per gas unit set for the transaction
    • gasUsed : <string> - The total amount paid for the transaction, a multiplication product of gasLimit and gasPrice
    • value : <string> - The value being transacted
    • 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

Request
curl --location 'https://eth-mainnet.blastapi.io/<project-id>/builder/getWalletTransactions?walletAddress=0x6Ba5DD023815104325a7d6EAE98A259f6ab44dEb&pageSize=10&fromBlock=18375873&toBlock=18375873'
Result
{
"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
}]
}