Skip to main content

getWalletTokenTransfers

Parameters​

  • walletAddress :(string) REQUIRED - The address of the wallet
  • contractAddress :(string) OPTIONAL - The address of the ERC20 token contract
  • fromBlock : (string) OPTIONAL - Indicate the starting block from which to get the transfers
  • toBlock : (string) OPTIONAL - Indicate ending block up to which to get the transfers
  • secondWalletAddress: (integer) OPTIONAL - Filter transfers involving the given wallet address and a second address
  • onlyIncoming: (bolean) OPTIONAL - Return only incoming transfers
  • onlyOutgoing: (bolean) 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 address of the wallet
  • count : <integer> - The number of allowances
  • nextPageKey: <string> - Key used to get the next page of results. Must be set to the value of nextPageKey returned in the previous response
  • tokenTransfers: <array> - The array of Token Transfer objects
    • contractAddress: <string> - The token contract address
    • contractDecimals : <string> - Token decimals specified in the contract
    • contractName: <string> - The name of the token
    • contractSymbols: <string> - The name of the token
    • fromAddress : <string> - Address from which the transfer originated
    • toAddress: <array> - Destination address for the transfer
    • value: <string> - Token amount
    • blockHash : <string> - The hash of the block
    • blockNumber : <integer> - The block height
    • blockTimestamp : <string> - The timestamp of the block
    • transactionHash: <string>- The hash of the transaction
    • transactionIndex: <integer> - The index of the transaction
    • logIndex : <integer> - The index of the log

Example Request and Result for getWalletTokenTransfers​

Request

curl --location 'https://eth-mainnet.blastapi.io/<project-id>/builder/getWalletTokenTransfers?walletAddress=0x58edF78281334335EfFa23101bBe3371b6a36A51&contractAddress=0xF411903cbC70a74d22900a5DE66A2dda66507255'

Result

{
    "walletAddress": "0x58edf78281334335effa23101bbe3371b6a36a51",
    "count": 100,
    "nextPageKey": "NDE4ZmU0ZjU4ZDNhOjE2OTg3NjI5MDI6MTg0NjI1NDQ6OTYwMDAxNjkwMDAwMDA",
    "tokenTransfers": [
        {
            "contractAddress": "0xf411903cbc70a74d22900a5de66a2dda66507255",
            "contractDecimals": "18",
            "contractName": "VERA",
            "contractSymbol": "VRA",
            "fromAddress": "0x4a48e7939558d97c806567a0f463baf5bcc39ad1",
            "toAddress": "0x58edf78281334335effa23101bbe3371b6a36a51",
            "value": "115633550000000000000000",
            "blockHash": "0x8a1ce1d83a2d08392b1d3c82399ca46c89fdd061613fc8a50894619fa8292b14",
            "blockNumber": 18469847,
            "blockTimestamp": "2023-10-31T11:35:47.000Z",
            "transactionHash": "0x42c65e1e013e6cf330814dc6e6a3328881050a6f71360b34720fe77c4b68df65",
            "transactionIndex": 121,
            "logIndex": 430
        },
        {
            "contractAddress": "0xf411903cbc70a74d22900a5de66a2dda66507255",
            "contractDecimals": "18",
            "contractName": "VERA",
            "contractSymbol": "VRA",
            "fromAddress": "0x999b3c530fd34f70d7abd90629447d300bf4b7f2",
            "toAddress": "0x58edf78281334335effa23101bbe3371b6a36a51",
            "value": "1890153550000000000000000",
            "blockHash": "0x8a1ce1d83a2d08392b1d3c82399ca46c89fdd061613fc8a50894619fa8292b14",
            "blockNumber": 18469847,
            "blockTimestamp": "2023-10-31T11:35:47.000Z",
            "transactionHash": "0x35c2e1597d8d9cb7a9fad2c24a4b9475ee86dddc58904a3347a596a206480c04",
            "transactionIndex": 120,
            "logIndex": 427
        },
```