如何使用 NFTScan NFT API 在 Polygon 网络上开发 Web3 应用-CSDN博客

Polygon 以前被称为 Matic Network是一种扩展的解决方案它提供多种工具来加快并降低区块链网络上交易的成本和复杂性。然而其区块链上的大量活动使以太坊因增长的传输成本和拥挤的流量几乎瘫痪。Polygon 诞生的主要目的是帮助以太坊解决链中的拥塞问题拥有大量侧链的多层次平台以有效且具有成本效益的方式疏通主平台来扩展以太坊并提供一个更简单的框架来构建互连网络。

另一方面Polygon 的另一个主要用途是改善用户体验。以太坊的手续费非常昂贵,普通用户无法负担且速度较慢。 Polygon 的高性能低的手续费和速度可以解决一般的用户问题。Polygon 的 NFT 生态系统正在蓬勃发展已经逐渐成为 Web2 公司 NFT 的首选目的地。

就 NFTScan 数据来看截至 11 月 3 日Polygon 网络上已累计发行 NFT 资产 692,876,807 枚NFT Collection 1,519,857 个产生交易记录 2,472,505,127 条有过交互的钱包地址 81,542,228 个总交易额 974,589,451 MATIC。

Polygon NFTScan

怎样访问 NFTScan NFT API

创建 NFTScan 开发者账号

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

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

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

查看 Polygon NFT API 文档

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

NFTScan 目前拥有全网最大最全的 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 数据的需求。

Polygon NFT API 模型

主要包括了以下三个模型接口包括里面一些 API 核心的字段的整体介绍和说明方便开发者知道怎么去获取数据利用这些信息服务于自己正在构建的 Dapp 服务。

Assets API"Assets"是 NFT 中最关键的数据字段用于唯一标识和描述数字资产。开发者可以通过提取 Polygon 区块链上 NFT 的"Assets"数据来获取全面的了解并构建相关应用。"Assets"对象提供了数字资产的唯一标识以及其整个生命周期的数据为开发者理解和应用 NFT 提供了基础。

Transactions API交易模型代表了区块链上一个 NFT 资产的全量交易数据为开发者提供 NFT 的完整生命周期交易信息。包括 NFT 的 mint、转移、销售、和其他交易活动为开发者提供了深入了解 NFT 资产在 Polygon 生态系统中的流动和演变过程的机会。NFTScan 不断地汇总来自各个区块链网络的 NFT 交易市场和相关交易合约信息目前 NFTScan 已收录用于追踪和了解 NFT 市场的动态同时也有助于开发者构建基于 NFT 的应用程序和工具。

Collections APINFTScan 获取与 NFT Collections 相关的描述、社交媒体及其他基本信息等都链下数据。NFTScan 通过各个区块链网络中最主流的 NFT 市场提供的 API 获取这些信息。此外当前地板价信息是基于 NFT 市场的订单信息的集中式数据也是通过 API 可获取的。

Polygon NFT API 检索

1/Retrieve Assets 系列

• Get NFTs by account通过钱包地址检索 NFT

• Get all NFTs by account检索钱包地址的所有 NFT并根据合约地址对 NFT 进行分组如果账户地址拥有的 NFT 总数超过 2000 个则返回的 NFT 将限制在 2000 个以下。在这种情况下开发者和用户可以通过分页查询请求按账户获取该账户地址拥有的所有 NFT

• Get minted NFTs by account检索该钱包地址的 Mint 过的 NFT

• Get NFTs by contract通过合约地址检索 NFT并按 token_id 升序排序

• Get single NFT检索单个 NFT

• Get multiple NFTs同时检索多个合约地址的 NFT

• Search NFTs该接口通过在请求正文中应用搜索筛选器来返回 NFT 资产列表。资产按 nftscan_id 升序排序

• Get NFTs by attributes该接口返回一组属于具有属性的 NFT 合约地址的 NFTNFT 按 token_id 升序排序

• Get all multi-chain NFTs by account该接口返回账户地址拥有的所有多链 NFTNFT 根据合约地址进行分组

这里我们通过 Get NFTs by contract 接口为

“/v2/assets/{contract_address}”

来检索一个合约地址下的 NFT 详情信息路径参数包括 contract_address 作为选择这里我们查询的是 Owlpha 下的 NFT。

点击 Try it数据返回如下数据响应结果显示该 NFT Collection 所以 item 的基础数据及元数据信息这里我们选择了 Owlpha可以看到项目下一共 3333 个 Items返回数据按照 token_id 进行排序例如 id 为 0 的 item

1)单个 item 基础数据

0x12aa01f646fe5c993c66c9c86eddad4e514f6cbc 及名称为 Owlpha这里查询的 NFT Token id 为 0在项目中的占比为 1协议标准为 erc721Mint 时的钱包地址/持有者钱包地址被铸造时的时间戳/Mint 的哈希地址/Token URI 的地址。

latest_trade_price(上次成交价)/latest_trade_symbol(上次成交价的货币)latest_trade_timestamp(上次成交时间戳)当前显示 null返还数值空表示该项目未进行过交易。

2)元数据从该项目的元数据可以看出 Metadata 数据托管在 ipfs 上格式为 image/png存储路径以及为对该图片的细节特征描述。

3)稀有度描述得分为 0.9080396907866151综合稀有度排名为 2494 名。​

2/ Retrieve Transactions 系列

• Get transactions by account该接口返回钱包地址的 NFT 交易列表

• Get transactions by contract该接口返回 NFT 合约地址的 NFT 交易列表

• Get transactions by NFT该接口返回单个 NFT 的 NFT 交易列表

• Search transactions该接口返回在请求正文中应用搜索过滤器来返回 NFT 交易列表

• Get transactions by to address该接口返回按交易参数过滤的 NFT 交易列表

• Get transactions by hash该接口返回根据交易哈希列表查询到的交易记录

这里我们通过 Get transactions by contract

“/v2/transactions/{contract_address}”这个接口检索某 NFT 合约地址的 NFT 交易记录查询参数可选择交易的 NFT 事件类型Mint/Transfer/Sale/Burn使用 ';' 分隔多个事件。​

同样这里我们检索 Owlpha 的 NFT 交易记录。按照 Mint 的事件类型结果响应数据包含这个 NFT Collection 下所有的 Items Mint 的所有关键数据如交易哈希值、From 和 To 地址、区块信息、消耗 Gas、交易时间戳等基础数据等 NFT 交易的特征信息。

3/ Retrieve Collections 系列

• Get an NFT collection根据 Collection 的合约地址查询详情包括概览及按照描述对 Item 进行分类持有者分布、平均价格、地板价等基本概括信息

• Search NFT collections此接口通过在请求正文中应用搜索过滤器来返回 Collection 列表的信息Collection 按部署块编号升序排序

• Get NFT collections by account该接口返回具有给定账户地址的项目列表信息Collection 按地板价从高到低排序

• Get NFT collections by ranking该接口返回具有给定排序字段的项目列表信息Collection 按给定的排序字段和给定的排序方向排序

这里我们通过接口 Get an NFT collection

“/v2/collections/{contract_address}”检索地址为 

0x12aa01f646fe5c993c66c9c86eddad4e514f6cbc 名称为 Owlpha 的详情信息

4/ Collection StatisticsCollection 统计分析系列

• 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 的顶级持有者分布

这里我们通过接口 Collection Top Holder 

“/v2/statistics/collection/holder/{contract_address}”主要返回一个 NFT Collection 下的持有量分布可参考 NFTScan Holders

5/ Account Statistics 系列

• Account Overview Statistics该接口返回账户地址的概览统计信息参考 NFTScan Overview

• Account Holding Distribution该接口返回账户地址的 NFT 持有分布统计信息参考 NFTScan Portfolio

• Account Holding NFT Trending该接口返回账户地址的 NFT 持有量或数量统计信息参考 NFTScan Portfolio

6/ Analytic Statistics 系列

该系列接口通常用于获取 NFTScan Polygon 网络上各与数据分析和统计有关的信息如 Trade Ranking、Mint Amount 等这类接口允许开发者或用户查询、分析、和检索与特定数据集或指标相关的统计数据。可以用于各种用途包括市场分析、趋势追踪、投资决策、以及了解特定数据的性质。

参考https://polygon.nftscan.com/analytics

7/ Refresh Metadata

• Refresh NFT metadata

• Refresh NFT metadata by contract

Refresh Metadata 这类接口可以帮助开发者或用户提交后台刷新元数据任务该任务审核后会刷新提交的指定 Item 或整个合约元数据。

8/ Other

• Get latest block number返回 NFTScan 已到达的最新块号

• Get NFT amount by account根据请求体中的搜索列表返回账户地址拥有的 ERC721 和 ERC1155 NFT 数量信息

• Get NFT owners by contract返回 ERC721 NFT 合约地址的所有者列表NFT 按 token_id 升序排序

• Get owners by an NFT返回 ERC1155 NFT 的所有者列表 NFT 按 account_address 升序排序

构建相关 NFT API 请求

当开发者在 NFTScan 的 API 文档中找到所需的 Polygon API 接口和参数后可以使用他们选择的编程语言例如 Python、Java、JavaScript 等来编写 API 请求代码。以下是一个示例演示如何使用 Python 来请求一个 NFT 合约地址的交易记录。在这个示例中我们使用的合约地址是

0x12aa01f646fe5c993c66c9c86eddad4e514f6cbc

并且使用 NFT 接口“/v2/transactions/{contract_address}”​

import requests
# Define the API endpoint and contract addressapi_endpoint = "https://api.nftscan.com/v2/transactions/"contract_address = "0x12aa01f646fe5c993c66c9c86eddad4e514f6cbc"  # Replace with the actual contract address
# Make the API requestresponse = requests.get(api_endpoint + contract_address)
# Check the response status codeif response.status_code == 200:    # Parse the JSON data from the API response    transactions = response.json()    # Process the transaction records for the NFT contract address...    for transaction in transactions:        print("Transaction Hash:", transaction["hash"])        print("Block Number:", transaction["blockNumber"])        # You can add more handling for transaction information...else:    print("API request failed, status code:", response.status_code)

在上述示例中我们构建了 API 端点和合约地址然后使用 requests.get 方法发起 GET 请求以获取 NFT 合约地址的交易记录。如果请求成功开发者可以从 API 响应的 JSON 数据中提取交易信息并进行处理。

---

About NFTScan

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 数据服务