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
        }
    ]
}

Last updated