Links

getWalletTokenTransfers

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

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
},
```