指南：如何使用 NFTScan API 获取 NFT Collection 全量数据

<!--StartFragment-->

获取完整和准确的 NFT Collection 全面数据对于开发者来说极为重要，不仅提供全面的洞察并支撑各种创新应用，还提供详细的数据能呈现出 Collection 的整体发展趋势，同时丰富的历史数据能够剖析其价值增长情况，判断未来潜力。

不同时间段的交易和活跃度进行对比不仅可以发现交易机会，其中 NFT Collection 持有者信息更能支持对用户群体进行划分，实施精准营销；除此之外，全面的数据支撑可视化呈现，丰富应用的展示内容和用户体验。利用强大的 NFT API，开发者可以基于海量数据进行建模和预测，制定智能投资策略。可以说，获取完整、准确的 NFT Collection 数据，对于开发者研究 NFT 市场，进行数据驱动决策，以及开发创新应用都具有重要价值。 

就 Ethereum NFTScan 数据来看，目前以太坊上共产生：NFT 合约数量 259,229；NFT 资产数量 146,341,468；NFT 链上记录数量 252,387,389；NFT 交互钱包地址数量 9,828,744。

当前开发者获取 NFT Collection 数据面临分散、不完整、难以识别等痛点，手动收集成本高且无法满足产品化海量数据需求，这给开发者的检索带来了很大难度。不同链上资产数不胜数，仅仅依靠合约地址无法有效区分，这些种种因素导致开发者很难快速定位到需要的 Collection 获得准确的信息。

通过 NFTScan  NFT API 丰富的过滤条件，可以按多链、合约地址、钱包地址等多维度进行组合筛选，帮助开发者精准定位目标 NFT Collection，获取该项目的全量数据。相比于分散查找，通过 NFTScan API 一个请求即可获得标准化的完整数据，极大地提升了开发效率。开发者可以快速找到自己需要的 Collection 数据，无需逐个解析不同来源的信息，合约数据无需自行抓取，整个获取流程简单高效，既节省了时间成本，也减少了开发工作量。可以说 NFTScan 的 NFT API 条件检索功能，使开发者获取 Collection 数据变得轻松顺畅，能够有效支持开发者构建 NFT 应用或进行数据分析。

怎样访问 NFTScan NFT API

创建 NFTScan 开发者账号

在开始使用 NFTScan API 之前，首先需要访问开发者网站并创建一个账户。前往 NFTScan 官方网站点击 NFTScan API “Sign Up”按钮进行注册。

https://developer.nftscan.com/user/signup

登录后在 Dashboard（面板）上找到自己独有的 API KAY，将其复制。访问 API 文档，将自己的 API KEY 输进 API 文档的相应位置。根据文档的指引，就可以开始使用 API 服务了。在 API 文档中，开发者可以找到多种可供选择的接口模式，根据需求来选择最合适的接口。

在 Dashboard 中，开发人员还可以查看自己 API 使用情况的统计数据，帮助记录历史使用数据。不仅如此，NFTScan 还为每位注册开发者提供 1M CU 的 API 调用服务，用于请求所有的 NFT API 接口，并且 CU 永不过期，用完为止！

查看 NFT API 文档

在成功注册开发者账号获取 API Key 后，您需要查看 NFTScan API 文档。API 文档包含了所有可以使用的 API 端点和参数，以及如何构建请求和处理响应的详细信息。请认真阅读 API 文档，并确保理解如何使用 API 来获取您需要的数据。NFTScan API 服务致力于帮助开发者改善获取 NFT 数据分析体验。

NFTScan 目前拥有全网最大最全的 NFT Collection 库，已支持 Ethereum、Solana、BNBChain、Bitcoin、Polygon、zkSync、Aptos、Linea、Base、Avalanche、Arbitrum、Optimism、Fantom、Moonbeam、PlatON、Cronos、Gnosis 17 条区块链的 NFT 全量数据，所涵盖的 NFT 数据全、种类丰富，提供一整套的接口来获得 ERC721 和 ERC1155 资产以及交易、项目、市场统计等信息，现在支持 50 多个针对 EVM 兼容链的公共接口，以及针对 Solana、Aptos、Bitcoin 的一批相同模型的接口，很大程度上满足了开发者索引多种类型的 NFT 数据的需求。

检索 NFT Collection 资产相关 API

Retrieve Collections：检索 NFT Collection 系列

• Get an NFT collection（根据 Collection 的合约地址查询详情，包括概览及按照描述对 Item 进行分类，持有者分布、平均价格、地板价等基本概括信息。
• Search NFT collections（此接口通过在请求正文中应用搜索过滤器来返回 Collection 列表的信息，Collection 按部署块编号升序排序。注意：仅使用 block_number 条件筛选数据时，block_number_start 和 block_number_end 之间的范围不能超过 10000）
• Get NFT collections by account（该接口返回具有给定账户地址的项目列表信息，Collection 按地板价价从高到低排序）
• Get NFT collections by ranking（该接口返回具有给定排序字段的项目列表信息，Collection 按给定的排序字段和给定的排序方向排序）

Collection Statistics：Collection 统计分析系列

• Collection Statistics（该接口提供 NFT Collection 的分析统计概览数据）
• Collection Trade Distribution（该接口主要提供项目交易分布）
• Collection Trending Statistics（主要返回一个项目的 Trading 统计排序）
• Collection Holding Amount Distribution（该接口可返回 NFT 项目持有量的分布信息）
• Collection Holding Period Distribution（数据返回 NFT 项目持有期分布信息）
• Collection Blue Chip Statistics（蓝筹项目统计概览数据）
• Collection Blue Chip List（该项目涉及的蓝筹项目清单，可参考 NFTScan Blue Chip Collection）
• Collection Top Holder（该 Collection 的顶级持有者分布）

1）Get NFT collections by account：

/v2/collections/own/{account_address} 通过该接口，我们这里请求的是账户地址：0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813 所有 NFT Collection

点击 Try it 数据响应结果：

该地址下一共持有 20 个 NFT Collection，按照地板价进行排序，以及对其持有项目基础信息描述等等，该地址下一共持有：BoredApeYachtClub（地板价 29 ETH）、MutantApeYachtClub（地板价 5.82 ETH）、BoredApeKennelClub（地板价 1.968 ETH）、Otherdeed（地板价 0.6194 ETH）、HV-MTL（地板价 0.532 ETH）等等，可见该巨鲸是猴子系列持仓大户。

2）Collection Statistics：

/v2/statistics/collection/{contract_address} 接口返回了一个 NFT Collection 全方位的统计数据及数据概览等多维度指标，通过该 API 可以从宏观层面全面了解一个集合的历史数据和整体发展状况，以进行深入的数据分析和模型建立，数据返回：

项目地址："0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

项目名称："BoredApeYachtClub"

协议标准："erc721"

logo_url："https://logo.nftscan.com/logo/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png"

items 总量：10000/持有者总数:5563

24h：最低价 0.0069e/平均价 28.2441e/交易额 1864.1129e/售出 66

历史交易总次数：43120

历史最高价：1080.69 eth

历史总交易额：1570264.1154 eth

市值：253847 eth

当前地板价：29 eth

交易额：1864.1129e（1d）/6969.425e（7d）/37905.4857e（30d）等等。

3）Collection Trade Distribution：

/v2/statistics/collection/trade/{contract_address} 主要返回一个 NFT Collection 在不同时间段的交易分布数据，具体可参考 NFTScan Traded Distribution：

https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Overview

4）Collection Top Holder：

/v2/statistics/collection/holder/{contract_address} 接口返回指定集合中持有者按照持有量排序，以及持有的该集合中的 NFT 数量和持有时间的分布描述，能够帮助分析集合的持有者分布情况，判断市场集中度，是进行集合级别研究的重要数据来源，可以参考 NFTScan Holders：

https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Holders

构建相关 NFT 请求

构建 NFTScan 相关 NFT 数据请求非常简单方便，开发者只需要在详尽的 API 文档中找到所需的接口，根据接口说明配置必要的请求参数，使用代码或 Postman 等工具按文档示例快速发起请求，就可以获取丰富的 NFT 数据，无需处理繁琐的链上提取和数据整合。

例如这里我们请求 BAYC：

0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 该项目下的 Collection Top Holder 的分布数据详情，以下是一个示例 Python 代码：

在这个示例中，我们使用 Python 的 requests 库来发送 GET 请求，获取 NFT Collection 的 Top Holder 分布数据详情，请确保已经安装了 requests 库，来根据需要进一步处理响应数据，例如提取和分析持有者的信息以及 NFT 的分布情况。NFTScan 为开发者统一封装链上数据，提供完整的响应格式说明，开发者无需关注底层实现细节，大大降低了获取 NFT 数据的门槛，使构建 NFT 应用变得简单高效。

About NFTScan

NFTScan 成立于 2021 年 4 月份，总部位于中国香港，是全球领先的 NFT 数据基础设施服务商，目前已支持 Bitcoin、Ethereum、BNBChain、Polygon、Solana、Linea、Arbitrum、Optimism、zkSync、Aptos 等在内的 17 条主流区块链网络。NFTScan 团队致力于为数以亿计的 Web3 用户提供简洁高效的 NFT 检索服务，为新一代金融科技公司提供安全稳定的多链 NFT 索引服务，用数据来推动 NFT 生态的繁荣发展！目前，NFTScan 在为包括 CMC、Binance NFT、Bybit Web3、KuCoin、HashKey Group 、SafePal、Mask、imToken、Enjin、Coin98、OneKey、TokenPocket、AlienSwap 等在内的 4000+ 开发者提供多链 NFT 数据支持！

相关网站：

NFTScan: https://nftscan.com/

Developer: https://developer.nftscan.com/

Twitter: @nftscan_com

Discord: https://discord.gg/nftscan

欢迎关注 NFTScan 官方推特获取最新动态，有关 NFT 数据服务等商务合作请联系 Telegram: Shier1992

<!--EndFragment-->