DEV Community

Cover image for Guide: How to Retrieve Complete NFT Collection Data Using NFTScan API
NFT Research
NFT Research

Posted on

Guide: How to Retrieve Complete NFT Collection Data Using NFTScan API

Obtaining complete and accurate NFT collection data is crucial for developers. It not only provides comprehensive insights and supports various innovative applications but also presents the overall development trends of the collection through detailed data. Additionally, rich historical data can be analyzed to assess its value growth and future potential.

Comparing transaction and activity data over different time periods not only helps identify trading opportunities but also provides valuable insights into segmenting user groups for precise marketing efforts, especially when it comes to NFT Collection holder information. Furthermore, comprehensive data supports visual presentations, enriching application content and enhancing user experiences.

Leveraging a powerful NFT API, developers can model and forecast based on massive data sets, enabling the formulation of intelligent investment strategies. It can be said that obtaining complete and accurate NFT Collection data holds significant value for developers researching the NFT market, making data-driven decisions, and developing innovative applications.

Looking at Ethereum NFTScan data, there are currently a total of 259,229 NFT contracts, 146,341,468 NFT assets, 252,387,389 on-chain NFT records, and 9,828,744 interacting wallet addresses on the Ethereum network.

Image description

Currently, developers face various challenges when trying to obtain NFT Collection data, including decentralization, incompleteness, and difficulty in identification. Manual data collection is expensive and cannot meet the demands for large-scale data required for product development, making data retrieval a significant challenge for developers. With an abundance of on-chain assets across different blockchains, relying solely on contract addresses is insufficient for effective differentiation. These factors make it difficult for developers to quickly locate the desired Collection and obtain accurate information.

Through the rich filtering options provided by the NFTScan NFT API, developers can combine multiple dimensions such as different blockchains, contract addresses, wallet addresses, and more to precisely filter data. This assists developers in accurately pinpointing their target NFT Collection and retrieving the complete dataset for that project. In contrast to scattered searching, the NFTScan API enables developers to obtain standardized and comprehensive data with a single request, significantly enhancing development efficiency.

Developers can rapidly access the Collection data they need without the need to individually parse information from various sources or manually fetch contract data. The entire retrieval process is straightforward and efficient, saving both time and development effort. It can be said that the NFTScan NFT API's advanced filtering capabilities make it easy and seamless for developers to obtain Collection data, effectively supporting the development of NFT applications or data analysis.

How to Access the NFTScan NFT API

Create a NFTScan Developer Account
Before using the NFTScan API, you need to visit the developer website and create an account. Go to the NFTScan official website and click the “Sign Up” button for NFTScan API registration.
NFTScan Developer: https://developer.nftscan.com/user/signup

Image description
Sign Up (NFTScan Developer Platform)

After logging in, find your unique API KEY on the Dashboard and copy it. Visit the API documentation and input your API KEY as guided. You can then start using the API service. In the API documentation, developers can find various interface modes to choose from based on their needs.

Image description
Dashboard (NFTScan Developer Platform)

In the Dashboard, developers can also view statistics on their API usage, helping to track historical usage data. Moreover, NFTScan provides each registered developer with 1M CU (Call Units) of API calls, allowing access to all NFT API interfaces, and CU never expires.

View the NFT API Documentation
After successfully registering as a developer and obtaining your API Key, you need to review the NFTScan API documentation. The API documentation includes all available API endpoints and parameters, along with detailed instructions on how to build requests and handle responses. Carefully read the API documentation and ensure you understand how to use the API to retrieve the data you need.

NFTScan API Documentation: https://docs.nftscan.com

NFTScan API services aim to enhance developers’ experience in obtaining NFT data analysis. NFTScan currently boasts the largest and most comprehensive NFT Collection library, supporting full NFT data for Ethereum, Solana, BNBChain, Bitcoin, Polygon, zkSync, Aptos, Linea, Base、Avalanche, Arbitrum, Optimism, Fantom, Moonbeam, PlatON, Cronos, and Gnosis on 17 blockchains.

The covered NFT data is diverse, providing a complete set of interfaces for accessing ERC721 and ERC1155 assets, transactions, projects, market statistics, and more. It supports over 50 public interfaces for EVM-compatible chains and a set of similar interfaces for Solana, Aptos, and Bitcoin, satisfying developers’ needs to index various types of NFT data.

Image description
NFTScan API Doc

  • Retrieve Collections: NFT Collection Asset-Related API
  • Get an NFT collection: Retrieve details based on the contract address of a Collection, including an overview, categorization of Items by description, distribution of holders, average prices, floor prices, and other basic summary information.
  • Search NFT collections: This API returns information about Collections by applying search filters in the request body. Collections are sorted in ascending order by deployment block number. Note: When filtering data using the block_number condition, the range between block_number_start and block_number_end should not exceed 10,000.
  • Get NFT collections by account: This API returns a list of projects associated with a given account address, sorted by floor price in descending order.
  • Get NFT collections by ranking: This API returns a list of projects based on a specified ranking field, sorted by the given sorting field and direction.

Collection Statistics: Collection Statistical Analysis Series

  • Collection Statistics: This API provides an overview of analytical statistics for NFT Collections.
  • Collection Trade Distribution: This API primarily provides information about project trade distribution.
  • Collection Trending Statistics: It primarily returns trading statistics ranking for a project.
  • Collection Holding Amount Distribution: This API can return distribution information for the amount of NFT holdings in a project.
  • Collection Holding Period Distribution: Data is returned regarding the distribution of NFT holding periods in a project.
  • Collection Blue Chip Statistics: Overview statistical data for blue-chip projects.
  • Collection Blue Chip List: A list of blue-chip projects associated with this project, referring to NFTScan Blue Chip Collection.
  • Collection Top Holder: Distribution of top holders for this Collection.

1)Get NFT collections by account:
/v2/collections/own/{account_address} Through this interface, we are requesting all NFT Collections owned by the account address: 0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813.

Image description

Click "Try it" and view the response results:
Under this address, there are a total of 20 NFT Collections, sorted by floor price, and providing basic information about the held projects. The address holds the following Collections: BoredApeYachtClub (Floor Price: 29 ETH), MutantApeYachtClub (Floor Price: 5.82 ETH), BoredApeKennelClub (Floor Price: 1.968 ETH), Otherdeed (Floor Price: 0.6194 ETH), HV-MTL (Floor Price: 0.532 ETH), and more. It's evident that this whale is a major holder of monkey-themed Collections.

Image description

2)Collection Statistics:
The /v2/statistics/collection/{contract_address} interface provides comprehensive statistical data and data overviews for an NFT Collection, covering multiple dimensions. Through this API, you can gain a macro-level understanding of a collection's historical data and overall development, enabling in-depth data analysis and model building. Here is the data returned:
Project Address: "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
Project Name: "BoredApeYachtClub"
Protocol Standard: "erc721"
Logo URL: "https://logo.nftscan.com/logo/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png"
Total Items: 10,000 / Total Owners: 5,563
24-Hour Stats: Lowest Price 0.0069 ETH / Average Price 28.2441 ETH / Volume 1864.1129 ETH / Sales 66
Total Historical Transactions: 43,120
Historical Highest Price: 1080.69 ETH
Total Historical Volume: 1,570,264.1154 ETH
Market Cap: 253,847 ETH
Current Floor Price: 29 ETH
Volume: 1864.1129 ETH (1 day) / 6969.425 ETH (7 days) / 37,905.4857 ETH (30 days), and more.

Image description

3)Collection Trade Distribution:
The /v2/statistics/collection/trade/{contract_address} primarily provides data on the trading distribution of an NFT Collection over different time periods. For specific details, you can refer to NFTScan Traded Distribution at the following link:
https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Overview

Image description

4)Collection Top Holder:
The /v2/statistics/collection/holder/{contract_address} interface returns a sorted list of holders within a specified collection based on their holdings. It also provides information about the number of NFTs held and the distribution of holding times within that collection. This data helps analyze the distribution of holders within the collection, assess market concentration, and is an important source of data for collection-level research. You can refer to NFTScan Holders at the following link for more information:
https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Holders

Image description

Build relevant NFT requests
Building NFTScan-related NFT data requests is straightforward and convenient. Developers only need to locate the desired API in the comprehensive API documentation, configure the necessary request parameters according to the API specifications, and quickly initiate requests using code or tools like Postman, following the documentation examples. This allows you to access rich NFT data without the need for cumbersome on-chain extraction and data integration.

For example, here's a request for Bored Ape Yacht Club (BAYC):
We are requesting distribution data details for Collection Top Holders under this project address: 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d. Below is an example Python code snippet:

Image description

In this example, we use the Python requests library to send a GET request and retrieve distribution details for the Top Holders of an NFT Collection. Please ensure that you have the requests library installed to further process the response data as needed, such as extracting and analyzing holder information and NFT distribution.
NFTScan provides a unified abstraction of on-chain data and offers comprehensive response format documentation. Developers do not need to concern themselves with the underlying implementation details, significantly lowering the barrier to accessing NFT data and simplifying the process of building NFT applications efficiently.

About NFTScan
NFTScan is the world’s largest NFT data infrastructure, including a professional NFT explorer and NFT developer platform, supporting the complete amount of NFT data for 17 blockchains including Ethereum, Solana, BNBChain, Arbitrum, Optimism, and other major blockchains, providing NFT API for developers on 16 blockchains.
Official Links:
NFTScan: https://nftscan.com/
Developer: https://developer.nftscan.com/
Twitter: https://twitter.com/nftscan_com
Discord: https://discord.gg/nftscan

Top comments (0)