{"content":{"title":"如何使用 NFTScan NFT API 在 Fantom 网络上开发 Web3 应用","body":"Fantom 是一个高吞吐量，且具有具有低交易成本和即时确定性的区块链。由于其 EVM 的兼容性，它被许多以太坊开发者用作扩展其 Web3 应用的方式。以太坊开发者可以用标准的以太坊开发者工具轻松部署他们现有的合约，同时使用更快的区块链，增加他们能够开发的 dApp 类型的多样性。\r\n\r\n\r\n\r\n根据 NFTScan 数据显示，截至 1 月 12 日，Fantom 网络上已累计发行 NFT 资产 8,237,504 枚，NFT Collection 13,010 个，产生交互记录 20,162,698 条，有过交互的钱包地址 1,054,024 个，总交易额 32,144,526.02 FTM。 \r\n\r\n\r\n\r\n\r\n**Fantom NFTScan：**[**https://fantom.nftscan.com/**](https://xie.infoq.cn/link?target=https%3A%2F%2Ffantom.nftscan.com%2F)\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/42/42dfab55d06d6cb7b7ef0d700672e3b6.png)\r\n\r\n\r\n\r\n\r\n**创建 NFTScan 开发者账号**\r\n\r\n\r\n\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\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**查看 Fantom 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、TON、Polygon、zkSync、Aptos、Linea、Base、Avalanche、Arbitrum、OP Mainnet、Starknet、Scroll、Viction、Fantom、Moonbeam、PlatON、Cronos、Gnosis 21 条区块链的 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/68/68639eaecd2cbbc023af8de26da283ff.png)\r\n\r\n\r\n\r\n\r\n**Fantom 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 中最关键的数据字段，用于唯一标识和描述数字资产。开发者可以通过提取 **Fantom** 区块链上 NFT 的\"Assets\"数据来获取全面的了解，并构建相关应用。\"Assets\"对象提供了数字资产的唯一标识以及其整个生命周期的数据，为开发者理解和应用 NFT 提供了基础。\r\n\r\n\r\n\r\n**Transactions API**：交易模型代表了区块链上一个 NFT 资产的全量交易数据，为开发者提供 NFT 的完整生命周期交易信息。包括 NFT 的 mint、转移、销售、和其他交易活动，为开发者提供了深入了解 NFT 资产在 **Fantom** 生态系统中的流动和演变过程的机会。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/78/782bbf7f65ec7eabdb6cd05cdee22a71.png)\r\n\r\n\r\n\r\n\r\n**Fantom 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 single NFT** 接口为“/v2/assets/{contract_address}/{token_id}”来检索一个合约地址下的某单个 NFT Item 的详情信息，路径参数包括 contract_address/token_id 作为选择，这里我们查询的是 **veEQUAL** 且 token id 为 **1** 的 NFT。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/dc/dcf819f4c936e5c81d33976c2f51783c.png)\r\n\r\n\r\n\r\n\r\n点击 Try it，数据返回如下，主要包括 NFT 资产合约地址的基础信息查询，元数据信息及稀有度描述。\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/99/99d6da1376271541e992e57d279a500a.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这里我们通过 **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/ad/adc29df84951654f3833f4a403f4b888.png)\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 an NFT collection**“/v2/collections/{contract_address}”检索地址为 \r\n\r\n0x8313f3551c4d3984ffbadfb42f780d0c8763ce94 名称为 **veEQUAL** 的详情信息：\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/36/36c0108393833d4020197ee593f34ba5.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 Holding Amount Distribution** \"/v2/statistics/amount/distribution/{contract_address}”主要返回一个 NFT Collection 的持有量分布信息，可参考 Fantom 链上 NFTScan Holding Amount Distribution：\r\n\r\n[https://fantom.nftscan.com/0x8313f3551c4d3984ffbadfb42f780d0c8763ce94?module=Holders](https://xie.infoq.cn/link?target=https%3A%2F%2Ffantom.nftscan.com%2F0x8313f3551c4d3984ffbadfb42f780d0c8763ce94%3Fmodule%3DHolders)\r\n\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/36/36e712c52dd8b46e4ddea5c948b0bbd7.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 Fantom 上各与数据分析和统计有关的信息，如 Trade Ranking、Mint Amount、Gas Ranking 等这类接口允许开发者或用户查询、分析、和检索与特定数据集或指标相关的统计数据。可以用于各种用途，包括市场分析、趋势追踪、投资决策、以及了解特定数据的性质。\r\n\r\n参考：[https://fantom.nftscan.com/analytics](https://xie.infoq.cn/link?target=https%3A%2F%2Ffantom.nftscan.com%2Fanalytics)\r\n\r\n\r\n\r\n\r\n\r\n![](https://static001.geekbang.org/infoq/5f/5f0bfc43055ba3ec008f09cf36899802.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 的 API 文档中找到所需的 Fantom API 接口和参数后，可以使用选择的编程语言(如 Python、Java、JavaScript 等)编写 API 请求代码。\r\n\r\n以下是一个示例，演示如何使用 Python 来请求一个 NFT 合约地址的交易记录。在这个示例中，我们使用 NFT 接口“/v2/transactions/{contract_address}”调取合约地址为 0x8313f3551c4d3984ffbadfb42f780d0c8763ce94 的交互记录：\r\n\r\n\r\n```import requests\r\n\r\n# Define the Fantom NFTScan API endpoint and contract address\r\napi_endpoint = \"https://api.nftscan.com/v2/transactions\"\r\ncontract_address = \"0x8313f3551c4d3984ffbadfb42f780d0c8763ce94\"\r\n\r\n# Construct the API request URL\r\nurl = f\"{api_endpoint}/{contract_address}\"\r\n\r\n# Make an HTTP GET request\r\nresponse = requests.get(url)\r\n\r\n# Check if the request was successful\r\nif response.status_code == 200:\r\n    # Get the returned JSON data\r\n    data = response.json()\r\n    # Process the returned contract address transaction records\r\n    print(\"Contract address transaction records:\")\r\n    print(data)  # This will print the retrieved contract address transaction records; you can further process or extract information as needed\r\nelse:\r\n    print(\"Request failed:\", response.status_code)\r\n\r\n```\r\n\r\n这段代码将向 Fantom NFTScan API 接点发送 HTTP GET 请求，以检索合约地址为该合约地址下的 NFT 交易记录。运行代码后，开发者将获取到该合约地址的交易记录，并可以根据需要进一步处理或提取信息。\r\n\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、Aptos 等在内的 21 条主流区块链网络。NFTScan 团队致力于为数以亿计的 Web3 用户提供简洁高效的 NFT 检索服务，为新一代金融科技公司提供安全稳定的多链 NFT 索引服务，用数据来推动 NFT 生态的繁荣发展！目前，NFTScan 在为包括 CMC、Binance NFT、Bybit、KuCoin、HashKey Group 、Mask Network、imToken、Enjin、Coin98 等在内的 5000+ 开发者提供多链 NFT 数据支持！**\r\n\r\n**相关网站：**\r\n\r\n***NFTScan:***[***https://nftscan.com/***](https://xie.infoq.cn/link?target=https%3A%2F%2Fnftscan.com%2F)\r\n\r\n\r\n***Developer:***[***https://developer.nftscan.com/***](https://xie.infoq.cn/link?target=https%3A%2F%2Fdeveloper.nftscan.com%2F)\r\n\r\n\r\n***Twitter: @nftscan_com***\r\n\r\n***Discord:***[***https://discord.gg/nftscan***](https://xie.infoq.cn/link?target=https%3A%2F%2Fdiscord.gg%2Fnftscan)"},"author":{"user":"https://learnblockchain.cn/people/10111","address":null},"history":null,"timestamp":1705055967,"version":1}