Obtain data for native currency and token transfers on a particular wallet address

Get Wallet & Token Transfers

The 'Get Wallet Transfers' and 'Get Token Transfers' endpoints allow users to retrieve data about various transfers, including native currency and tokens (ERC-20, ERC-721, ERC-1155). These endpoints provide flexibility in accessing transfer data based on specific criteria.

  • EOA Address: extract transfers bound with a particular wallet address.
  • Direction: filter transfers based on their direction, either incoming or outgoing OR return transfers with any direction if not specified.
  • Origin: obtain transfers based on the transaction origin address OR return transfers from any origin if not specified.
  • Asset_type: filter transfers based on the specified asset type OR include only transfers of fungible tokens if not specified.
  • Contract: retrieve transfers specific to a particular contract OR from any contract if not specified.
  • Block/Time Range: define a range of blocks or a time interval to filter transfers within OR search the entire history if not specified.

Let's explore some examples that demonstrate how to utilize this endpoint effectively.

Get all transfers on a specific wallet

Here's an example of how to pull out all transfers on a particular wallet to see its transaction history and which tokens it has. The request below retrieves every transfer that has ever happened on the specified wallet on the Ethereum Mainnet. Be sure to replace 'YOUR_API_KEY' with your actual API key.

curl --request GET \
--url 'https://api.parsiq.net/tsunami/eip155-1/v1/address/0xD85F68bC77024A730302a97c2e1e07785b01f153/transfers?block_number_start=1&block_number_end=latest&limit=100&asset_type=native%2Cft%2Cnft' \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'

Get all transfers or NFT collections on a specific wallet

Suppose you want to view all the NFTs from the specified collection we have ever purchased. The following request pulls out every incoming NFT transfer that has ever happened on the specified wallet on the Ethereum Mainnet. Be sure to replace 'YOUR_API_KEY' with your actual API key.

curl --request GET \
--url 'https://api.parsiq.net/tsunami/eip155-1/v1/address/0xD85F68bC77024A730302a97c2e1e07785b01f153/transfers?direction=incoming&block_number_start=1&block_number_end=latest&limit=100&asset_type=nft&contract=0xcaace84b015330c0ab4bd003f6fa0b84ec6c64ac' \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'

Get all USDT/USDC transfers on a specific wallet

Suppose you want to view all USDC/USDT transfers on a particular wallet. The request below extracts every USDC/USDT transfer that has ever happened on the specified wallet on the Ethereum Mainnet. Be sure to replace 'YOUR_API_KEY' with your actual API key.

curl --request GET \
--url 'https://api.parsiq.net/tsunami/eip155-1/v1/address/0x05f6B37F7FCaffF6AC43C45CE3E8122Afd379349/transfers?direction=incoming&block_number_start=1&block_number_end=latest&limit=100&asset_type=ft&contract=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48%2C0xdac17f958d2ee523a2206206994597c13d831ec7' \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'