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=0xf16E9B0D03470827A95CDfd0Cb8a8A3b46969B91&pageSize=10&fromBlock=183773&toBlock=18375873'
Result
{
"wallet_address": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"count": 10,
"nextPageKey": "MDg0OTM1Njc5M2I0OjE2OTg2NzQ5NjM6MTgzNzU4NzE6Mjg",
"transactions": [
{
"transactionHash": "0x31aa547aa414bc14acf57a3a28ed01fc0177be81422df705e1999e2c0683ecda",
"transactionIndex": 28,
"blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
"blockNumber": 18375873,
"blockTimestamp": "2023-10-18T07:51:59.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x8b3870df408ff4d7c3a26df852d41034eda11d81",
"nonce": 2096257,
"minerAddress": "0x388c818ca8b9251b393131c08a736a67ccb19297",
"gasLimit": "100000",
"gasPrice": "7305248398",
"gasUsed": "30852",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a5100000000000000000000000000000000000000000000000000000970f8669c1b",
"status": 1,
"type": 2
},
{
"transactionHash": "0x61cd71ef9f4f62807d6c6ba124e2bfafde4db5778f6830df0b81794b8ed29aa7",
"transactionIndex": 27,
"blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
"blockNumber": 18375873,
"blockTimestamp": "2023-10-18T07:51:59.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x013062189dc3dcc99e9cee714c513033b8d99e3c",
"nonce": 2096256,
"minerAddress": "0x388c818ca8b9251b393131c08a736a67ccb19297",
"gasLimit": "100000",
"gasPrice": "7305248398",
"gasUsed": "29640",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a510000000000000000000000000000000000000000000008d5df38fe835121a9cf",
"status": 1,
"type": 2
},
{
"transactionHash": "0x1ee520efe1acefefa9bb0cd5d28909687502f8802b393a4a82a8049f27885166",
"transactionIndex": 26,
"blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
"blockNumber": 18375873,
"blockTimestamp": "2023-10-18T07:51:59.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x3392d8a60b77f8d3eaa4fb58f09d835bd31add29",
"nonce": 2096255,
"minerAddress": "0x388c818ca8b9251b393131c08a736a67ccb19297",
"gasLimit": "100000",
"gasPrice": "7305248398",
"gasUsed": "29622",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a5100000000000000000000000000000000000000000000ef9fdf3d985deea66f42",
"status": 1,
"type": 2
},
{
"transactionHash": "0xd3247160a219478a375784cdc923f8d1e9f29c8051de964061a9499675dafbd0",
"transactionIndex": 25,
"blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
"blockNumber": 18375873,
"blockTimestamp": "2023-10-18T07:51:59.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0xf57e7e7c23978c3caec3c3548e3d615c346e79ff",
"nonce": 2096254,
"minerAddress": "0x388c818ca8b9251b393131c08a736a67ccb19297",
"gasLimit": "100000",
"gasPrice": "7305248398",
"gasUsed": "29856",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a51000000000000000000000000000000000000000000001f2d0039a6c857c2aa00",
"status": 1,
"type": 2
},
{
"transactionHash": "0xcba6e1371e83963e46643133ec7ec81639efe47591c36d3a8f84aaef40bcb351",
"transactionIndex": 62,
"blockHash": "0x332ed82f861fa1c065992f7c9168461301a37b742bee49bad07b886bc645ee43",
"blockNumber": 18375872,
"blockTimestamp": "2023-10-18T07:51:47.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x767fe9edc9e0df98e07454847909b5e959d7ca0e",
"nonce": 2096253,
"minerAddress": "0x690b9a9e9aa1c9db991c7721a92d351db4fac990",
"gasLimit": "65318",
"gasPrice": "7186734336",
"gasUsed": "39658",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a5100000000000000000000000000000000000000000000014f370e890f23553644",
"status": 1,
"type": 2
},
{
"transactionHash": "0x440086a42b0d6defeb010d3d2204b1ecb783521d1fbfb4333d407ed31e1418c8",
"transactionIndex": 61,
"blockHash": "0x332ed82f861fa1c065992f7c9168461301a37b742bee49bad07b886bc645ee43",
"blockNumber": 18375872,
"blockTimestamp": "2023-10-18T07:51:47.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x5d3a4f62124498092ce665f865e0b38ff6f5fbea",
"nonce": 2096252,
"minerAddress": "0x690b9a9e9aa1c9db991c7721a92d351db4fac990",
"gasLimit": "100000",
"gasPrice": "7186734336",
"gasUsed": "34812",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a510000000000000000000000000000000000000000007fd74bd8f68bd3ee888052",
"status": 1,
"type": 2
},
{
"transactionHash": "0xfce87c33907c237e6f03ede6bb934ed0bf9ee7ee224326baee6be55b7800c074",
"transactionIndex": 60,
"blockHash": "0x332ed82f861fa1c065992f7c9168461301a37b742bee49bad07b886bc645ee43",
"blockNumber": 18375872,
"blockTimestamp": "2023-10-18T07:51:47.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x2dff88a56767223a5529ea5960da7a3f5f766406",
"nonce": 2096251,
"minerAddress": "0x690b9a9e9aa1c9db991c7721a92d351db4fac990",
"gasLimit": "100000",
"gasPrice": "7186734336",
"gasUsed": "48823",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a51000000000000000000000000000000000000000000018b7dc803ebcefd3b35f0",
"status": 1,
"type": 2
},
{
"transactionHash": "0x2a714e38b640af440860690c9cb2090b1ab2244a47492808e122cf93f64d6735",
"transactionIndex": 39,
"blockHash": "0x15a2469fb0f50c0d3ed93970b06aeedcfe88fdc0e979808e3d0977b934e9e303",
"blockNumber": 18375871,
"blockTimestamp": "2023-10-18T07:51:35.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0xd794dd1cada4cf79c9eebaab8327a1b0507ef7d4",
"nonce": 2096250,
"minerAddress": "0x7adc0e867ebc337e2d20c44db181c067fa08637b",
"gasLimit": "100000",
"gasPrice": "7536589491",
"gasUsed": "36426",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a5100000000000000000000000000000000000000000002ebc9a81d91d65cab1c09",
"status": 1,
"type": 2
},
{
"transactionHash": "0xdf1ea72239a82d0c8152c9117f6e5e07db898bc5218fffe078257f7bfe033739",
"transactionIndex": 38,
"blockHash": "0x15a2469fb0f50c0d3ed93970b06aeedcfe88fdc0e979808e3d0977b934e9e303",
"blockNumber": 18375871,
"blockTimestamp": "2023-10-18T07:51:35.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x6f259637dcd74c767781e37bc6133cd6a68aa161",
"nonce": 2096249,
"minerAddress": "0x7adc0e867ebc337e2d20c44db181c067fa08637b",
"gasLimit": "100000",
"gasPrice": "7536589491",
"gasUsed": "29943",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a510000000000000000000000000000000000000000000004297c37b8aa1292dce8",
"status": 1,
"type": 2
},
{
"transactionHash": "0x2b85a8435870117dc2f920861df4349ba7948675321bbea1bd15f3e4bc8cd146",
"transactionIndex": 28,
"blockHash": "0x15a2469fb0f50c0d3ed93970b06aeedcfe88fdc0e979808e3d0977b934e9e303",
"blockNumber": 18375871,
"blockTimestamp": "2023-10-18T07:51:35.000Z",
"fromAddress": "0xf16e9b0d03470827a95cdfd0cb8a8a3b46969b91",
"toAddress": "0x4297394c20800e8a38a619a243e9bbe7681ff24e",
"nonce": 2096248,
"minerAddress": "0x7adc0e867ebc337e2d20c44db181c067fa08637b",
"gasLimit": "100000",
"gasPrice": "7536589491",
"gasUsed": "29753",
"value": "0",
"contractAddress": null,
"input": "0xa9059cbb00000000000000000000000058edf78281334335effa23101bbe3371b6a36a510000000000000000000000000000000000000000000a5a57f1833bfc9cb772ed",
"status": 1,
"type": 2
}
]
}