{"content":{"title":"如何使用 NFTScan NFT API 在 zkSync 网络上开发 Web3 应用","body":"<!--StartFragment-->\r\n\r\nzkSync 是由 Matter Labs 创建的，是一个以用户为中心的 zk rollup 平台，它是以太坊的第 2 层扩展解决方案，使用 zk-rollups 作为扩展技术，与 optimistic rollups 一样，zk-rollups 将会汇总以太坊主网上的交易并将交易证明提交给以太坊。zkSync Era 是一个基于 zkSync 技术的区块链生态系统，旨在实现高性能、低成本的智能合约和区块链应用。 zkSync Era 是完全开源的，可以自由地查看、修改和分叉代码，zkSync 2.0 现在是 zkSync Era，而 zkSync 1.0 现在是 zkSync Lite。\r\n\r\n\r\n\r\n\r\n就 NFTScan 数据来看，截至 11 月 7 日，zkSync Era 网络上已累计发行 NFT 资产 16,207,719 枚，NFT Collection 78,973 个，产生交易记录 22,020,416 条，有过交互的钱包地址 2,565,626 个，总交易额 566,890.33 ETH。\r\n\r\n\r\n\r\n\r\nzkSync NFTScan：[https://zksync.nftscan.com/](https://xie.infoq.cn/link?target=https%3A%2F%2Fzksync.nftscan.com%2F)\r\n\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/0e/0ebec1881cbdab254df88d82d92889ed.png)\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\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/e7/e716243785661283940c7332ac4dd370.png)\r\n\r\n\r\n\r\n\r\n登录后在 Dashboard（面板）上找到自己独有的 API KAY，将其复制。访问 API 文档，将自己的 API KEY 输进 API 文档的相应位置。根据文档的指引，就可以开始使用 API 服务了。在 API 文档中，开发者可以找到多种可供选择的接口模式，根据需求来选择最合适的接口。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/2a/2a36dbcb7aa6c9b008a345724ab09686.png)\r\n\r\n\r\n\r\n\r\n在 Dashboard 中，开发人员还可以查看自己 API 使用情况的统计数据，帮助记录历史使用数据。不仅如此，NFTScan 还为每位注册开发者提供 1M CU 的 API 调用服务，用于请求所有的 NFT API 接口，并且 CU 永不过期，用完为止！\r\n\r\n\r\n\r\n\r\n**查看 zkSync Era 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、TON、Polygon、zkSync、Aptos、Linea、Base、Avalanche、Arbitrum、Optimism、Scroll、Fantom、Moonbeam、PlatON、Cronos、Gnosis 19 条区块链的 NFT 全量数据，所涵盖的 NFT 数据全、种类丰富，提供一整套的接口来获得 ERC721 和 ERC1155 资产以及交易、项目、市场统计等信息，现在支持 60 多个针对 EVM 兼容链的公共接口，以及针对 Solana、Aptos、Bitcoin、TON 的一批相同模型的接口，很大程度上满足了开发者索引多种类型的 NFT 数据的需求。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/6e/6e5ffe734d8eba168262ad2ad915bee0.png)\r\n\r\n\r\n\r\n\r\n**zkSync NFT API 模型**\r\n\r\n\r\n\r\n\r\n主要包括了以下三个模型接口，包括里面一些 API 核心的字段的整体介绍和说明，方便开发者知道怎么去获取数据利用这些信息服务于自己正在构建的 Dapp 服务。\r\n\r\n\r\n\r\n\r\n**Assets API**：\"Assets\"是 NFT 中最关键的数据字段，用于唯一标识和描述数字资产。开发者可以通过提取 **zkSync Era** 区块链上 NFT 的\"Assets\"数据来获取全面的了解，并构建相关应用。\"Assets\"对象提供了数字资产的唯一标识以及其整个生命周期的数据，为开发者理解和应用 NFT 提供了基础。\r\n\r\n\r\n\r\n\r\n**Transactions API**：交易模型代表了区块链上一个 NFT 资产的全量交易数据，为开发者提供 NFT 的完整生命周期交易信息。包括 NFT 的 mint、转移、销售、和其他交易活动，为开发者提供了深入了解 NFT 资产在 **zkSync Era** 生态系统中的流动和演变过程的机会。NFTScan 不断地汇总来自各个区块链网络的 NFT 交易市场和相关交易合约信息，目前 NFTScan 已收录用于追踪和了解 NFT 市场的动态，同时也有助于开发者构建基于 NFT 的应用程序和工具。\r\n\r\n\r\n\r\n\r\n**Collections API**：NFTScan 获取与 NFT Collections 相关的描述、社交媒体及其他基本信息等都链下数据。NFTScan 通过各个区块链网络中最主流的 NFT 市场提供的 API 获取这些信息。此外当前地板价信息是基于 NFT 市场的订单信息的集中式数据，也是通过 API 可获取的。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/2a/2a34a35ef4316a75e34fb9705fe2a65c.png)\r\n\r\n\r\n\r\n\r\n**zkSync NFT API 检索**\r\n\r\n\r\n\r\n\r\n**1/Retrieve Assets 系列**\r\n\r\n* Get NFTs by account（通过钱包地址检索 NFT）\r\n* Get all NFTs by account（检索钱包地址的所有 NFT，并根据合约地址对 NFT 进行分组，如果账户地址拥有的 NFT 总数超过 2000 个，则返回的 NFT 将限制在 2000 个以下。在这种情况下，开发者和用户可以通过分页查询请求按账户获取该账户地址拥有的所有 NFT）\r\n* Get minted NFTs by account（检索该钱包地址的 Mint 过的 NFT）\r\n* Get NFTs by contract（通过合约地址检索 NFT，并按 token_id 升序排序）\r\n* Get single NFT（检索单个 NFT）\r\n* Get multiple NFTs（同时检索多个合约地址的 NFT）\r\n* Search NFTs（该接口通过在请求正文中应用搜索筛选器来返回 NFT 资产列表。资产按 nftscan_id 升序排序）\r\n* Get NFTs by attributes（该接口返回一组属于具有属性的 NFT 合约地址的 NFT，NFT 按 token_id 升序排序）\r\n* Get all multi-chain NFTs by account（该接口返回账户地址拥有的所有多链 NFT，NFT 根据合约地址进行分组）\r\n\r\n\r\n\r\n\r\n这里我们通过 **Get all multi-chain NFTs by account** 接口为“**/v2/assets/chain/{account_address}**” 来检索某个钱包地址下单链或多链持有的 NFT 的详情信息，路径参数包括 account_address，查询参数包括 erc_type（erc721/erc1155）/chain（NFTScan 支持的 15 条 evm 兼容链）这里我们查询的是 0xeb71d303a6cee4ba28e9c5adc1af308892fb681b 下持有的 eth 及 zkSync NFT 详情信息。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/3e/3e88dd57ba60fa100a9216a7df3cd0b5.png)\r\n\r\n\r\n\r\n\r\n点击 Try it，数据返回如下，主要包括该地址下持有的 eth 及 zkSync NFT 资产基础信息查询：\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/f7/f78e25459df12071b7d16c0bb4cc39e8.png)\r\n\r\n\r\n\r\n\r\n**2/ Retrieve Transactions 系列**\r\n\r\n* Get transactions by account（该接口返回钱包地址的 NFT 交易列表）\r\n* Get transactions by contract（该接口返回 NFT 合约地址的 NFT 交易列表）\r\n* Get transactions by NFT（该接口返回单个 NFT 的 NFT 交易列表）\r\n* Search transactions（该接口返回在请求正文中应用搜索过滤器来返回 NFT 交易列表）\r\n* Get transactions by to address（该接口返回按交易参数过滤的 NFT 交易列表）\r\n* Get transactions by hash（该接口返回根据交易哈希列表查询到的交易记录）\r\n\r\n\r\n\r\n\r\n这里我们通过 **Get transactions by account**“/v2/transactions/account/{account_address}”这个接口，检索某钱包地址的 zkSync 网络上 NFT 交易记录，查询参数可选择交易的 NFT 事件类型（**Mint/Transfer/Sale/Burn**），使用 ';' 分隔多个事件。\r\n\r\n同样这里我们检索 0xeb71d303a6cee4ba28e9c5adc1af308892fb681b 地址下的 NFT 交易记录。按照 Mint 的事件类型，结果响应数据包含该地址所有的 Items Mint 的所有关键数据，如交易哈希值、From 和 To 地址、区块信息、消耗 Gas、交易时间戳等基础数据等 NFT 交易的特征信息。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/f0/f08a2b7a1f228603a2597bf397f3d1a2.png)\r\n\r\n\r\n\r\n\r\n**3/ Retrieve Collections 系列**\r\n\r\n* Get an NFT collection（根据 Collection 的合约地址查询详情，包括概览及按照描述对 Item 进行分类，持有者分布、平均价格、地板价等基本概括信息）\r\n* Search NFT collections（此接口通过在请求正文中应用搜索过滤器来返回 Collection 列表的信息，Collection 按部署块编号升序排序）\r\n* Get NFT collections by account（该接口返回具有给定账户地址的项目列表信息，Collection 按地板价从高到低排序）\r\n* Get NFT collections by ranking（该接口返回具有给定排序字段的项目列表信息，Collection 按给定的排序字段和给定的排序方向排序）\r\n\r\n\r\n\r\n\r\n这里我们通过接口 **Get NFT collections by account** “/v2/collections/own/{account_address}”检索地址为 0xeb71d303a6cee4ba28e9c5adc1af308892fb681b 持有的 NFT Collection 详情信息，返回数据包含 20 个 data：\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/87/87a29f8e0283d582eb26a3311c20f015.png)\r\n\r\n\r\n\r\n\r\n**4/ 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\r\n\r\n\r\n这里我们通过接口 **Collection Trending Statistics** “/v2/statistics/collection/trending/{contract_address}”主要返回一个 NFT Collection 的 Trading 统计排序，可参考 NFTScan Trending：[https://zksync.nftscan.com/0xad8a95b347b96274940229754dfd8569f2b72bf4](https://xie.infoq.cn/link?target=https%3A%2F%2Fzksync.nftscan.com%2F0xad8a95b347b96274940229754dfd8569f2b72bf4)\r\n\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/f2/f2970ca7f2c4650b7c0d7d7038e9d84d.png)\r\n\r\n\\\r\n\r\n\r\n**5/ Account Statistics 系列**\r\n\r\n* Account Overview Statistics（该接口返回账户地址的概览统计信息，参考 NFTScan Overview）\r\n* Account Holding Distribution（该接口返回账户地址的 NFT 持有分布统计信息，参考 NFTScan Portfolio）\r\n* Account Holding NFT Trending（该接口返回账户地址的 NFT 持有量或数量统计信息，参考 NFTScan Portfolio）\r\n\r\n\r\n\r\n\r\n**6/ Analytic Statistics 系列**\r\n\r\n该系列接口通常用于获取 NFTScan zkSync Era 网络上各与数据分析和统计有关的信息，如 Trade Ranking、Mint Amount 等这类接口允许开发者或用户查询、分析、和检索与特定数据集或指标相关的统计数据。可以用于各种用途，包括市场分析、趋势追踪、投资决策、以及了解特定数据的性质。\r\n\r\n参考：[https://zksync.nftscan.com/analytics](https://xie.infoq.cn/link?target=https%3A%2F%2Fzksync.nftscan.com%2Fanalytics)\r\n\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/8f/8f01998858d5876c98f91b93cf01cc0e.png)\r\n\r\n\r\n\r\n\r\n**7/ Refresh Metadata**\r\n\r\n* Refresh NFT metadata\r\n* Refresh NFT metadata by contract\r\n\r\nRefresh Metadata 这类接口可以帮助开发者或用户提交后台刷新元数据任务，该任务审核后会刷新提交的指定 Item 或整个合约元数据。\r\n\r\n\r\n\r\n\r\n**8/ Other**\r\n\r\n* Get latest block number（返回 NFTScan 已到达的最新块号）\r\n* Get NFT amount by account（根据请求体中的搜索列表返回账户地址拥有的 ERC721 和 ERC1155 NFT 数量信息）\r\n* Get NFT owners by contract（返回 ERC721 NFT 合约地址的所有者列表，NFT 按 token_id 升序排序）\r\n* Get owners by an NFT（返回 ERC1155 NFT 的所有者列表， NFT 按 account_address 升序排序）\r\n\r\n\r\n\r\n\r\n**构建相关 NFT API 请求**\r\n\r\n\r\n\r\n\r\n构建 NFTScan 相关 NFT 数据请求非常简单方便，开发者只需要在 API 文档中找到所需的接口，查看接口地址、请求方法、请求参数等说明。然后根据自身需求选择编程语言，如 JavaScript、Python、Java 等，使用该语言的 HTTP 请求库向接口地址发送构造好的请求，筛选必要的头信息和参数。整个调用过程快速便捷，开发者可以完全根据文档说明来实施。\r\n\r\n例如，我们请求 0xeb71d303a6cee4ba28e9c5adc1af308892fb681b 持有的 NFT Collection 详情信息，使用接口：“**/v2/collections/own/{account_address}**”，HTTP GET 请求访问 NFTScan 的 API 端点，使用 Python 的 requests 库，可以这样构建请求：\r\n\r\n\r\n\r\n\r\n```\r\nimport requests\r\n# Define the API URL with address parameterapi_url = \"https://api.nftscan.com/v2/collections/own/0xeb71d303a6cee4ba28e9c5adc1af308892fb681b\"  \r\n# Send GET requestresponse = requests.get(api_url)\r\n# Check status code  if response.status_code == 200:\r\n  # Request succeeded, print response data  data = response.json()  print(data)  else:  # Request failed  print(\"Request failed with status code:\", response.status_code)\r\n```\r\n\r\n\r\n\r\n\r\n\r\n\r\n主要步骤包括：构造 API 接口 URL，并填入 account_address 参数，使用 requests 库发送 GET 请求；检查返回状态码，200 表示调用成功；请求成功就可以处理返回的 JSON 数据了；也做了错误处理，打印状态码。\r\n\r\n\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 年初，总部位于香港，是全球领先的 NFT 数据基础设施服务商，目前已支持 Bitcoin、Ethereum、BNBChain、Polygon、Solana、TON、Arbitrum、Optimism、zkSync、Base、Scroll、Aptos 等在内的 19 条主流区块链网络。NFTScan 团队致力于为数以亿计的 Web3 用户提供简洁高效的 NFT 检索服务，为新一代金融科技公司提供安全稳定的多链 NFT 索引服务，用数据来推动 NFT 生态的繁荣发展！目前，NFTScan 在为包括 MetaMask、CMC、Binance NFT、Bybit、KuCoin、HashKey Group 、Mask、imToken、Enjin、Coin98 等在内的 5000+ 开发者提供多链 NFT API 数据服务！**\r\n\r\n<!--EndFragment-->"},"author":{"user":"https://learnblockchain.cn/people/10111","address":null},"history":null,"timestamp":1699530348,"version":1}