Get Native & Token Transfers by address endpoint allows to pull any native currency, ERC20, ERC721, and ERC1155 token transfers for the specified wallet address.

Get Native & Token Transfers by Address

Get Native & Token Transfers by Address endpoint provides access to all transfers (native currency, ERC20, ERC721, and ERC1155 token transfers):

  • for the specified wallet Address
  • of the specified Direction (incoming or outgoing), or with any Direction, if not specified
  • of the specified transaction Origin address, or with any Origin, if not specified
  • of the specified Asset Types, or of FTs, if not specified
  • on a specified Contract, or on any Contract, if not specified
  • within a specified block/time range or across all history, if not specified

Now, let's dive into the examples of how this endpoint might be used.

Get all transfers on the specified wallet

Let us say we want to pull all transfers on the specified wallet to see the transaction history and which tokens it has.

This request will pull every transfer that ever happened on the specified wallet on ETH Mainnet. Make 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 the specified NFT collection for the specified wallet

Let us say we want to see all NFTs of the specified collection we have ever bought.

This request will pull every incoming NFT transfer that ever happened on the specified wallet on ETH Mainnet. Make 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 and USDC transfers on the specified wallet

Let us say we want to see all USDC and USDT transfers on the specified wallet.

This request will pull every USDC and USDT transfer that ever happened on the specified wallet on ETH Mainnet. Make 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'