Links

getWalletTokenTransfers

Get all incoming and outgoing ERC20 token transfers for the given wallet address in reverse chronological order (most recent first)
Efficiently access a complete history of ERC20 token transfers, encompassing both incoming and outgoing transactions, specifically related to the provided wallet address. The information is meticulously sorted in reverse chronological order, ensuring that the most recent transfers are prominently displayed at the beginning of the list. This capability offers valuable insights into the token movement associated with the wallet, providing a comprehensive view of transaction activity over time.

How to use getWalletTokenTransfers method ?

Below, you'll find an in-depth guide that provides a comprehensive explanation of how to utilize the getWalletTokenTransfers method effectively using Blast Builder API.

Parameters

Field
Type
Description
walletAddress
string
The address of the wallet
contractAddress
string
The address of the ERC20 token contract
fromBlock
string
Indicate the starting block from which to get the transfers
toBlock
string
Indicate ending block up to which to get the transfers
secondWalletAddress
integer
Filter transfers involving the given wallet address and a second address
onlyIncoming
boolean
Return only incoming transfers. Default is false. If set to true, only incoming token transfers are included. If set to true, onlyOutgoing must be false.
onlyOutgoing
boolean
Return only outgoing transfers. Default is false. If set to true, only outgoing token transfers are included. If set to true, onlyIncoming must be false.
pageSize
integer
Number of records to be retrieved on one page
pageKey
string
Key used to get the next page of results. Must be set to the value of nextPageKey returned in the previous response

Returns

In this section, you will find a comprehensive list of parameters returned as part of the response for the 'getWalletTokenTransfers' API method. These parameters provide essential information about ERC20 token transfers, including details about the wallet, token contracts, transfer values, and blockchain block-related data. This information is valuable for tracking and analyzing token transfer activity associated with the provided wallet address
Returns array of Token Transfer objects.
This API is paginated, response items are ordered descending by:
  • blockNumber
  • transferIndex
Field
Type
Description
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 symbol of the token
fromAddress
string
Address from which the transfer originated
toAddress
array
Destination address for the transfer (multiple allowed)
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

In this section, we present an illustrative example of a request made using the 'getWalletTokenTransfers' API method, along with a detailed breakdown of the resulting data. This example serves as a practical reference to demonstrate how to retrieve token transfer information, helping you understand and utilize the API effectively.
The example in this section uses a non-existing project id.
Make sure you replace it with your Starknet endpoint when issuing the Builder API calls.
Don't have a project id? Here's a straightforward guide on how to obtain one!
get
https://starknet-mainnet.blastapi.io/<project-id>/builder/getWalletTokenTransfers?
Parameters
Query
walletAddress
0x069e5becf53bed3a73c3ebaaeb3deee49fd9fc1da31f9be3b3e34d761cd630ee
contractAddress
0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7
Responses
200: OK
Expand for a detailed response example

Curl request example

curl --location 'https://starknet-mainnet.blastapi.io/<project-id>/builder/getWalletTokenTransfers?walletAddress=0x069e5becf53bed3a73c3ebaaeb3deee49fd9fc1da31f9be3b3e34d761cd630ee&contractAddress=0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7'