{"content":{"title":"指南：如何使用 NFTScan API 获取 NFT Collection 全量数据","body":"<!--StartFragment-->\r\n\r\n获取完整和准确的 NFT Collection 全面数据对于开发者来说极为重要，不仅提供全面的洞察并支撑各种创新应用，还提供详细的数据能呈现出 Collection 的整体发展趋势，同时丰富的历史数据能够剖析其价值增长情况，判断未来潜力。\r\n\r\n\r\n\r\n\r\n不同时间段的交易和活跃度进行对比不仅可以发现交易机会，其中 NFT Collection 持有者信息更能支持对用户群体进行划分，实施精准营销；除此之外，全面的数据支撑可视化呈现，丰富应用的展示内容和用户体验。利用强大的 NFT API，开发者可以基于海量数据进行建模和预测，制定智能投资策略。可以说，获取完整、准确的 NFT Collection 数据，对于开发者研究 NFT 市场，进行数据驱动决策，以及开发创新应用都具有重要价值。 \r\n\r\n\r\n\r\n\r\n就 Ethereum NFTScan 数据来看，目前以太坊上共产生：NFT 合约数量 259,229；NFT 资产数量 146,341,468；NFT 链上记录数量 252,387,389；NFT 交互钱包地址数量 9,828,744。\r\n\r\n![](https://static001.geekbang.org/infoq/d8/d89dd5badc74cff2d06736eaf5f5677d.png)\r\n\r\n当前开发者获取 NFT Collection 数据面临分散、不完整、难以识别等痛点，手动收集成本高且无法满足产品化海量数据需求，这给开发者的检索带来了很大难度。不同链上资产数不胜数，仅仅依靠合约地址无法有效区分，这些种种因素导致开发者很难快速定位到需要的 Collection 获得准确的信息。\r\n\r\n\r\n\r\n通过 NFTScan  NFT API 丰富的过滤条件，可以按多链、合约地址、钱包地址等多维度进行组合筛选，帮助开发者精准定位目标 NFT Collection，获取该项目的全量数据。相比于分散查找，通过 NFTScan API 一个请求即可获得标准化的完整数据，极大地提升了开发效率。开发者可以快速找到自己需要的 Collection 数据，无需逐个解析不同来源的信息，合约数据无需自行抓取，整个获取流程简单高效，既节省了时间成本，也减少了开发工作量。可以说 NFTScan 的 NFT API 条件检索功能，使开发者获取 Collection 数据变得轻松顺畅，能够有效支持开发者构建 NFT 应用或进行数据分析。\r\n\r\n\r\n\r\n\r\n**怎样访问 NFTScan NFT API**\r\n\r\n\r\n\r\n\r\n**创建 NFTScan 开发者账号**\r\n\r\n在开始使用 NFTScan API 之前，首先需要访问开发者网站并创建一个账户。前往 NFTScan 官方网站点击 NFTScan API “Sign Up”按钮进行注册。\r\n\r\n[https://developer.nftscan.com/user/signup](https://xie.infoq.cn/link?target=https%3A%2F%2Fdeveloper.nftscan.com%2Fuser%2Fsignup)\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/e7/e716243785661283940c7332ac4dd370.png)\r\n\r\n登录后在 Dashboard（面板）上找到自己独有的 API KAY，将其复制。访问 API 文档，将自己的 API KEY 输进 API 文档的相应位置。根据文档的指引，就可以开始使用 API 服务了。在 API 文档中，开发者可以找到多种可供选择的接口模式，根据需求来选择最合适的接口。\r\n\r\n![](https://static001.geekbang.org/infoq/2a/2a36dbcb7aa6c9b008a345724ab09686.png)\r\n\r\n在 Dashboard 中，开发人员还可以查看自己 API 使用情况的统计数据，帮助记录历史使用数据。不仅如此，NFTScan 还为每位注册开发者提供 1M CU 的 API 调用服务，用于请求所有的 NFT API 接口，并且 CU 永不过期，用完为止！\r\n\r\n\r\n\r\n\r\n**查看 NFT API 文档**\r\n\r\n\r\n\r\n\r\n在成功注册开发者账号获取 API Key 后，您需要查看 NFTScan API 文档。API 文档包含了所有可以使用的 API 端点和参数，以及如何构建请求和处理响应的详细信息。请认真阅读 API 文档，并确保理解如何使用 API 来获取您需要的数据。NFTScan API 服务致力于帮助开发者改善获取 NFT 数据分析体验。\r\n\r\n\r\n\r\n\r\nNFTScan 目前拥有全网最大最全的 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 数据的需求。\r\n\r\n![](https://static001.geekbang.org/infoq/e2/e2f544e0829776449074d73bc493fe7e.png)\r\n\r\n**检索 NFT Collection 资产相关 API**\r\n\r\n\r\n\r\n\r\n**Retrieve Collections：检索 NFT Collection 系列**\r\n\r\n* Get an NFT collection（根据 Collection 的合约地址查询详情，包括概览及按照描述对 Item 进行分类，持有者分布、平均价格、地板价等基本概括信息。\r\n* Search NFT collections（此接口通过在请求正文中应用搜索过滤器来返回 Collection 列表的信息，Collection 按部署块编号升序排序。注意：仅使用 block_number 条件筛选数据时，block_number_start 和 block_number_end 之间的范围不能超过 10000）\r\n* Get NFT collections by account（该接口返回具有给定账户地址的项目列表信息，Collection 按地板价价从高到低排序）\r\n* Get NFT collections by ranking（该接口返回具有给定排序字段的项目列表信息，Collection 按给定的排序字段和给定的排序方向排序）\r\n\r\n\r\n\r\n**Collection Statistics：Collection 统计分析系列**\r\n\r\n* Collection Statistics（该接口提供 NFT Collection 的分析统计概览数据）\r\n* Collection Trade Distribution（该接口主要提供项目交易分布）\r\n* Collection Trending Statistics（主要返回一个项目的 Trading 统计排序）\r\n* Collection Holding Amount Distribution（该接口可返回 NFT 项目持有量的分布信息）\r\n* Collection Holding Period Distribution（数据返回 NFT 项目持有期分布信息）\r\n* Collection Blue Chip Statistics（蓝筹项目统计概览数据）\r\n* Collection Blue Chip List（该项目涉及的蓝筹项目清单，可参考 NFTScan Blue Chip Collection）\r\n* Collection Top Holder（该 Collection 的顶级持有者分布）\r\n\r\n![](https://static001.geekbang.org/infoq/d9/d9fba6e85f93aa984d8b24949429567c.png)\r\n\r\n**1）Get NFT collections by account：**\r\n\r\n/v2/collections/own/{account_address} 通过该接口，我们这里请求的是账户地址：0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813 所有 NFT Collection\r\n\r\n![](https://static001.geekbang.org/infoq/f2/f2991a81b91472d78ecca22293700db3.png)\r\n\r\n点击 Try it 数据响应结果：\r\n\r\n该地址下一共持有 20 个 NFT Collection，按照地板价进行排序，以及对其持有项目基础信息描述等等，该地址下一共持有：BoredApeYachtClub（地板价 29 ETH）、MutantApeYachtClub（地板价 5.82 ETH）、BoredApeKennelClub（地板价 1.968 ETH）、Otherdeed（地板价 0.6194 ETH）、HV-MTL（地板价 0.532 ETH）等等，可见该巨鲸是猴子系列持仓大户。\r\n\r\n![](https://static001.geekbang.org/infoq/4b/4b013c1f8dec5b733769c0f09fc9e60a.png)\r\n\r\n\r\n\r\n\r\n**2）Collection Statistics：**\r\n\r\n/v2/statistics/collection/{contract_address} 接口返回了一个 NFT Collection 全方位的统计数据及数据概览等多维度指标，通过该 API 可以从宏观层面全面了解一个集合的历史数据和整体发展状况，以进行深入的数据分析和模型建立，数据返回：\r\n\r\n项目地址：\"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d\"\r\n\r\n项目名称：\"BoredApeYachtClub\"\r\n\r\n协议标准：\"erc721\"\r\n\r\nlogo_url：\"[https://logo.nftscan.com/logo/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png](https://xie.infoq.cn/link?target=https%3A%2F%2Flogo.nftscan.com%2Flogo%2F0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png)\"\r\n\r\nitems 总量：10000/持有者总数:5563\r\n\r\n24h：最低价 0.0069e/平均价 28.2441e/交易额 1864.1129e/售出 66\r\n\r\n历史交易总次数：43120\r\n\r\n历史最高价：1080.69 eth\r\n\r\n历史总交易额：1570264.1154 eth\r\n\r\n市值：253847 eth\r\n\r\n当前地板价：29 eth\r\n\r\n交易额：1864.1129e（1d）/6969.425e（7d）/37905.4857e（30d）等等。\r\n\r\n![](https://static001.geekbang.org/infoq/82/82c5ea4ccf7d6d16b636ad20ed43e3a5.png)\r\n\r\n\r\n\r\n\r\n**3）Collection Trade Distribution：**\r\n\r\n/v2/statistics/collection/trade/{contract_address} 主要返回一个 NFT Collection 在不同时间段的交易分布数据，具体可参考 NFTScan Traded Distribution：\r\n\r\n[https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Overview](https://xie.infoq.cn/link?target=https%3A%2F%2Fwww.nftscan.com%2F0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d%3Fmodule%3DOverview)\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/47/47d95835daaf6da6cc4f815a8b4e087b.png)\r\n\r\n\r\n\r\n\r\n**4）Collection Top Holder：**\r\n\r\n/v2/statistics/collection/holder/{contract_address} 接口返回指定集合中持有者按照持有量排序，以及持有的该集合中的 NFT 数量和持有时间的分布描述，能够帮助分析集合的持有者分布情况，判断市场集中度，是进行集合级别研究的重要数据来源，可以参考 NFTScan Holders：\r\n\r\n[https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Holders](https://xie.infoq.cn/link?target=https%3A%2F%2Fwww.nftscan.com%2F0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d%3Fmodule%3DHolders)\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/1d/1d8724296f1d4bd5f97f84058cabb18b.png)\r\n\r\n\r\n\r\n\r\n**构建相关 NFT 请求**\r\n\r\n\r\n\r\n构建 NFTScan 相关 NFT 数据请求非常简单方便，开发者只需要在详尽的 API 文档中找到所需的接口，根据接口说明配置必要的请求参数，使用代码或 Postman 等工具按文档示例快速发起请求，就可以获取丰富的 NFT 数据，无需处理繁琐的链上提取和数据整合。\r\n\r\n例如这里我们请求 BAYC：\r\n\r\n0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 该项目下的 Collection Top Holder 的分布数据详情，以下是一个示例 Python 代码：\r\n\r\n![](https://static001.geekbang.org/infoq/d3/d37d67d201d9f0482fbcd96559f1de58.png)\r\n\r\n在这个示例中，我们使用 Python 的 requests 库来发送 GET 请求，获取 NFT Collection 的 Top Holder 分布数据详情，请确保已经安装了 requests 库，来根据需要进一步处理响应数据，例如提取和分析持有者的信息以及 NFT 的分布情况。NFTScan 为开发者统一封装链上数据，提供完整的响应格式说明，开发者无需关注底层实现细节，大大降低了获取 NFT 数据的门槛，使构建 NFT 应用变得简单高效。\r\n\r\n\r\n\r\n\r\n***\r\n\r\n**About NFTScan**\r\n\r\n\r\n\r\n\r\n**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 数据支持！**\r\n\r\n##### 相关网站：\r\n\r\nNFTScan: [***https://nftscan.com/***](https://xie.infoq.cn/link?target=https%3A%2F%2Fnftscan.com%2F)\r\n\r\n\r\nDeveloper: [***https://developer.nftscan.com/***](https://xie.infoq.cn/link?target=https%3A%2F%2Fdeveloper.nftscan.com%2F)\r\n\r\n***Twitter: @nftscan_com***\r\n\r\nDiscord: [***https://discord.gg/nftscan***](https://xie.infoq.cn/link?target=https%3A%2F%2Fdiscord.gg%2Fnftscan)\r\n\r\n\r\n**欢迎关注 NFTScan 官方推特获取最新动态，有关 NFT 数据服务等商务合作请联系 Telegram: Shier1992**\r\n\r\n<!--EndFragment-->"},"author":{"user":"https://learnblockchain.cn/people/10111","address":null},"history":null,"timestamp":1693539585,"version":1}