getWalletTransactions
Parameters
walletAddress
:(string)
REQUIRED - The address of the walletfromBlock
:(string)
OPTIONAL - Indicate the starting block from which to get the transactionstoBlock
: (string)
OPTIONAL - Indicate ending block up to which to get the transactionssecondWalletAddress
:(string)
OPTIONAL -Filter transactions involving the given wallet address and a second addressonlyIncoming
:(boolean)
OPTIONAL - Return only incoming transfersonlyOutgoing
:(boolean)
OPTIONAL - Return only outgoing transferspageSize
:(integer)
OPTIONAL - Number of records to be retrieved on one pagepageKey
:(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 holdercount
:<integer>
- The number of transactionsnextPageKey
:<string>
- Key to get the next page of results, if more results are availabletransactions
:<array>
- Array of Transaction objectstransactionHash
:<string>
- The hash of the transactiontransactionIndex
:<integer>
- The index of the transactionblockHash
:<string>
- The hash of the block containing the transactionblockNumber
:<integer>
- The height of the block containing the transactionblockTimestamp
:<string>
- The timestamp of the block in which the transfer transaction was executedfromAddress
:<string>
- The address executing the transactiontoAddress
:<string>
- The address on the receiving end of the transactionnonce
:<integer>
- The number of transactions sent from the sender addressminerAddress
:<string>
- The address of the validator that mined the blockgasLimit
:<string>
- The maximum amount of gas you set for the transactiongasPrice
:<string>
- The price per gas unit set for the transactiongasUsed
:<string>
- The total amount paid for the transaction, a multiplication product of gasLimit and gasPricevalue
:<string>
- The value being transactedcontractAddress
:<string>
- The address of the contractinput
:<string>
- Additional data included for this transactionstatus
:<integer>
- The status for the transactiontype
:<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
}
]
}