Getting the list of nfts the address owns is not so easy

When we build a NFT marketplace service, we need to list nfts that the user, here the address have. But actually there is no such a sufficient way to gather them.

Today, I would like to show you a sample implementation of listing nfts logic with Etherscan API and Nodejs (Typescript).

Requirements as follows;

In this example, we have done this in a simple way using the Etherscan API. Etherscan APIs are really useful and easy to use when you want to collect Ethereum event log data. But of course you can build your own Ethereum Node and collect data from them :>

Firstly, we have to say that the only way to view the nfts that an address has is to collect all erc-721 forwarding history data for that address and find it out by filtering out the nfts that have not been forwarded to other addresses. That’s why we need to collect transfer event data.

Let’s start coding!

Typescript sample implementations

0. Read API doc!

  1. Declare Event History Type.
Type for Etherscan API response data

2. API call logic (Recursive)

call Etherscan API recursively to fetch all the history data

In this example, the function above takes two arguments, the first is the address to be checked for nfts, and the last is for recursive pagination. As you can see in the API docs, Etherscan API requires some pagination related parameters, and to collect all data, we need to call API recursively.

3. Filtering data

use lodash to calculate easily

After gathering data, we need to filter them to find out which the address currently have and which are already transferred to the other. In this example, we use lodash library to calculate easily. Reduce function reduces collection to a value which is the accumulated result of running each element in collection thru iteratee, where each successive invocation is supplied the return value of the previous. We make a object, which key consists of contract address and tokenId, which is unique, and the value is just a number (maybe boolean flag is better). If the token is transferred to the address, increment the number, and if the token is transferred to the other address, decrement the number. Thus we can list nfts which the address currently owns.


By using the Etherscan API to filter the event data of the transfer event, we were finally able to list the nfts owned by that address. To get a list of NFTs owned by that address, by retrieving transfer events and filtering them, is not intuitive, but once implemented it is easy to understand. I hope you enjoyed this article and got some tips of NFTs!



example nft listing website:

interested in crypto and art

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium

Star Atlas a Blockchain Metaverse Powered by The Solana Protocol

IoTeX Mainnet v1.2 — Web3.js for Ethereum Tools on IoTeX & Node/Database Upgrades

API3 Public Token Distribution Event

#AskMediconnect : the answers to your questions

[PoS Round-Up] Polkadot launches new parachain testnet, Cosmos community discusses marketing…

Why the 2020s is the decade of Blockchain technology

The Decentralized Metaverse

NEM Malaysia Hosts First-ever Women in Blockchain Asia

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Hiroyuki Tachibana

Hiroyuki Tachibana

interested in crypto and art

More from Medium

MGC NFT Image Loading Speed Improvement (up to 17x faster)

Top 5 Marketplaces To Buy/Sell NFTs

NFTs and Authenticity (Part 1)

Koguns NFT 101 — Turning Trades Into Game and Empowering The Polygon Ecosystem.

Koguns Trading banner