{"content":{"title":"如何使用 NFTScan NFT API 在 Avalanche 网络上开发 Web3 应用","body":"<!--StartFragment-->\r\n\r\nAvalanche 是一个高度可扩展网络，支持每秒交易处理量(TPS)较高且交易手续费较低的定制应用程序专用区块链，它的原生代币是 AVAX。Avalanche 致力于在不影响速度或去中心化的前提下提升可扩展性。其核心平台有三条区块链：交易链（X 链）、合约链（C 链）及平台链（P 链）。X 链用于创建和交易资产，C 链用于创建智能合约，P 链用于协调验证者和子网。Avalanche-C 链是基于 Snowman 共识协议创建的合约链，支持智能合约，兼容 EVM，开发者可以方便快捷地在 C 链上部署智能合约和构建 DApp。 \r\n\r\n\r\n\r\n\r\n就 NFTScan 数据来看，截至 11 月 24 日，Avalanche-C 网络上已累计发行 NFT 资产 15,601,161 枚，NFT Collection 215,667 个，产生交易记录 36,165,993 条，有过交互的钱包地址 2,321,649 个，总交易额 2,067,664.69 AVAX。\r\n\r\nAvalanche-C NFTScan：[https://avax.nftscan.com/](https://xie.infoq.cn/link?target=https%3A%2F%2Favax.nftscan.com%2F)\r\n\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/05/050cf8a3bb62f226b845eedbae7d7a3f.png)\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\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**查 Avalanche-C 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、Viction、Fantom、Moonbeam、PlatON、Cronos、Gnosis 20 条区块链的 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**Avalanche-C NFT API 模型**\r\n\r\n\r\n\r\n\r\n主要包括了以下三个模型接口，包括里面一些 API 核心的字段的整体介绍和说明，方便开发者知道怎么去获取数据利用这些信息服务于自己正在构建的 Dapp 服务。\r\n\r\n\r\n\r\n**Assets API**：\"Assets\"是 NFT 中最关键的数据字段，用于唯一标识和描述数字资产。开发者可以通过提取 **Avalanche-C** 区块链上 NFT 的\"Assets\"数据来获取全面的了解，并构建相关应用。\"Assets\"对象提供了数字资产的唯一标识以及其整个生命周期的数据，为开发者理解和应用 NFT 提供了基础。\r\n\r\n\r\n\r\n\r\n**Transactions API：**交易模型代表了区块链上一个 NFT 资产的全量交易数据，为开发者提供 NFT 的完整生命周期交易信息。包括 NFT 的 mint、转移、销售、和其他交易活动，为开发者提供了深入了解 NFT 资产在 **Avalanche-C** 生态系统中的流动和演变过程的机会。NFTScan 不断地汇总来自各个区块链网络的 NFT 交易市场和相关交易合约信息，目前 NFTScan 已收录用于追踪和了解 NFT 市场的动态，同时也有助于开发者构建基于 NFT 的应用程序和工具。\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/69/69df2620e6e2b431f16c3c873a328901.png)\r\n\r\n\r\n\r\n\r\n**Avalanche-C 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这里我们通过一个钱包地址来检索 NFT，使用接口 **Get all NFTs by account**：\r\n\r\n/v2/account/own/all/{account_address}，查询参数包括协议标准：erc721/erc1155；排序字段：mint_time/own_time/last_trade_price（仅适用于 erc721）。我们这里请求的是地址：\r\n\r\n0xf2d850d518e4e165c17e6a9c7aa1ffdb00ca0244 Avalanche-C 链上所有的 erc721 协议的 NFT。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/63/637affe7b47c99bb9e1e63d8b76a9e70.png)\r\n\r\n\r\n\r\n\r\n点击 Try it 数据响应结果：该地址下一共持有 41 个 items，按 floor_price 降序排序，返回数据包括每个 NFT contract 地址以及 name，持有数量及该 contract 地址下 item 数量，地板价以及一些的基础细节信息描述等等。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/98/9881c5036182480aa05aa89a57b31cc1.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 contract** 这个接口，检索某个合约地址的交易记录，查询参数可选择交易的 NFT 事件类型（Mint/Transfer/Sale/Burn），使用 ';' 分隔多个事件。这里按照 Mint 的事件类型，输入自己的 api-key 之后，结果响应数据包含这笔 NFT 交易的所有关键数据，如交易哈希值、区块信息、From 和 To 地址、合约地址、交易时间戳等基础数据外，还有 Token ID、交易金额等 NFT 交易的特征信息。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/cb/cb747f2a07fee592f124272937cbf253.png)\r\n\r\n\r\n\r\n\r\n**3/ Retrieve Collections 系列**\r\n\r\n\r\n\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这里我们通过接口 **Get NFT collections by account**\r\n\r\n“/v2/collections/own/{account_address}”检索钱包地址依旧为 \r\n\r\n0xf2d850d518e4e165c17e6a9c7aa1ffdb00ca0244 \r\n\r\n协议标准为 erc721 的 NFT Collection 详情信息，返回了 20 个 data：\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/60/608ef42b807306b5dc25b3694e3d3aaf.png)\r\n\r\n\r\n\r\n\r\n**4/ Collection Statistics：Collection 统计分析系列**\r\n\r\n\r\n\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 Holding Period Distribution** \r\n\r\n/v2/statistics/period/distribution/{contract_address}”主要返回一个 NFT Collection 的持有期分布信息，可参考 Avalanche-C 链上 NFTScan Holding Period Distribution：\r\n\r\n[https://linea.nftscan.com/0xb62c414abf83c0107db84f8de1c88631c05a8d7b](https://xie.infoq.cn/link?target=https%3A%2F%2Flinea.nftscan.com%2F0xb62c414abf83c0107db84f8de1c88631c05a8d7b)\r\n\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/93/9339663bb72b7c0e22eec18a4235e367.png)\r\n\r\n\r\n\r\n\r\n**5/ Account Statistics 系列**\r\n\r\n\r\n\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\r\n\r\n\r\n该系列接口通常用于获取 NFTScan Avalanche-C  网络上各与数据分析和统计有关的信息，如 Trade Ranking、Mint Amount 等这类接口允许开发者或用户查询、分析、和检索与特定数据集或指标相关的统计数据。可以用于各种用途，包括市场分析、趋势追踪、投资决策、以及了解特定数据的性质。\r\n\r\n参考：[https://avax.nftscan.com/analytics](https://xie.infoq.cn/link?target=https%3A%2F%2Favax.nftscan.com%2Fanalytics)\\\r\n\r\n\r\n\\\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/0a/0ac1944a78131c3a158ae09d95303b65.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调用 NFTScan 的 NFT API 获取 NFT 数据，对开发者来说是极为轻松简单的。整个过程只需要参考文档，寻找所需接口的调用说明，包括请求地址、方法和必要参数。然后用任意一种熟悉的编程语言，如 JavaScript、Python 或者 Java，使用语言内置的请求库，按文档中接口说明构建请求,配置请求头及参数信息。向定义的接口地址发送请求，即可获得返回的 JSON 格式数据。开发者可以完全根据接口文档来实施请求的构造，无需过多自己推导，整个调用流程极速，使用门槛很低。\r\n\r\n例如，我们通过 **Get transactions by contract **接口请求 \r\n\r\n0x8927985b358692815e18f2138964679dca5d3b79 \r\n\r\n该地址的交易记录，使用接口：\r\n\r\n“**/v2/transactions/{contract_address}**”，HTTP GET 请求访问 NFTScan 的 API 端点，使用 Python 的 requests 库，可以这样构建请求：\r\n\r\n* \r\n\r\n\r\n\r\n```import requests\r\n\r\n# NFTScan API base URL\r\nbase_url = \"https://api.nftscan.com/v2\"\r\n\r\n# Contract address for transactions\r\ncontract_address = \"0x8927985b358692815e18f2138964679dca5d3b79\"\r\n\r\n# Construct the complete API endpoint URL\r\nendpoint = f\"{base_url}/transactions/{contract_address}\"\r\n\r\n# Make a GET request\r\nresponse = requests.get(endpoint)\r\n\r\n# Check the response status code\r\nif response.status_code == 200:\r\n    # If the response is successful, print the returned data\r\n    data = response.json()\r\n    print(data)\r\nelse:\r\n    # If the request fails, print the error message\r\n    print(\"Request failed:\", response.status_code)\r\n\r\n```\r\n\r\n\r\n\r\n总体而言，这段代码发送了一个 HTTP GET 请求到指定的端点，可以作为一个基本框架，向 NFTScan 的 API 发送请求并获取交易记录数据，为进一步处理和分析数据提供了一个起点。\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**NFTScan 成立于 2021 年初，总部位于香港，是全球领先的 NFT 数据基础设施服务商，目前已支持 Bitcoin、Ethereum、BNBChain、Polygon、Solana、TON、Arbitrum、Optimism、zkSync、Aptos 等在内的 20 条主流区块链网络。NFTScan 团队致力于为数以亿计的 Web3 用户提供简洁高效的 NFT 检索服务，为新一代金融科技公司提供安全稳定的多链 NFT 索引服务，用数据来推动 NFT 生态的繁荣发展！目前，NFTScan 在为包括 CMC、Binance NFT、Bybit、KuCoin、HashKey Group 、Mask Network、imToken、Enjin、Coin98 等在内的 5000+ 开发者提供多链 NFT 数据支持！**\r\n\r\n<!--EndFragment-->"},"author":{"user":"https://learnblockchain.cn/people/10111","address":null},"history":null,"timestamp":1700980139,"version":1}