如何应用 NFTScan NFT API 在 Aptos 网络上开发 Web3 应用

<!--StartFragment-->

Aptos 是由前谷歌员工在 2018 年创立的 Layer 1 区块链，于去年 10 月上线主网，其目标是建设一个可扩展、安全、可信任和可升级的智能合约平台，采用 BFT 共识机制和并行计算机制，实现更好的性能。改进领导者轮换的机制，降低单个节点故障对网络的影响，提高网络运营的安全性。总体来说，Aptos 通过技术创新提升了区块链的扩展性和安全性，是一条非常适合金融应用场景的新型公链。

目前来看 Aptos NFT 生态处在高速发展的阶段，就 NFTScan 数据来看，截至 10 月 27 日，Aptos 网络上已累计发行 NFT 资产 2,153,877 枚，NFT Collection 20,065 个，产生交易记录 4,986,765 条，有过交互的钱包地址 904,660 个，总交易额 2,157,848.25  APT。

Aptos NFTScan: https://aptos.nftscan.com/

目前除了兼容 EVM 的 15 条链， NFTScan 还支持了另外 4 条是非 EVM 区块链：Bitcoin、TON、Solana 及 Aptos。要统计和分析整个 Aptos 生态的各种数据，NFTScan 能提供强大的数据支持，无论开发者需要跟 NFT 的流动、用户互动、市场趋势，还是进行复杂的数据挖掘和可视化，NFTScan 都提供了丰富的工具和功能，以满足数据分析需求，帮助开发者更好地理解和优化 Aptos NFT 生态。

怎样访问 NFTScan NFT API

创建 NFTScan 开发者账号

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

https://developer.nftscan.com/user/signup

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

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

查看 Aptos 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 数据的需求。

Aptos NFT API

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

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

NFTScan Aptos API 中的核心数据模型即为 Assets，它代表了每一个独特的数字项目，主要包括了 token id、collection 名称、tx_hash、区块 number、mint 价格、持有者等全面数据。

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

用户可以通过 Transactions API 获取任意 NFT 资产完整的交易记录、行为及当前所有权信息，实现对 NFT 的全面跟踪，为开发者分析 NFT 的交易特征、价格走势、流转路径等提供了全面可靠的数据来源。

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

NFTScan 会持续跟踪新出现的 NFT 项目，并快速获取其在各交易平台公开的链下数据信息，通过 NFT Collections API 开放给开发者，开发者可以无需逐个聚合不同平台的数据，就可以通过 Collections API 获取项目的链下描述、持有者、交易活动等关键信息，并集成数据于应用中。

查询相关 NFT API

1/ Get all NFTs by account: /apt/account/own/all/{account_address}

用于获取特定钱包地址"account_address"下拥有的所有 NFT 资产的数据信息，这个接口允许用户查询和检索与指定账户相关的所有 NFT 资产，包括其名称、ID、合约地址、所有权信息以及其他相关的 NFT 数据。通过这个接口可以获取特定账户在 Aptos 生态系统中的 NFT 持有情况，以便进行个性化的 NFT 资产管理、监测或展示。

输入检索钱包地址，点击 try it，返回数据如下：

2/ Get transactions by collection: /apt/transactions/collection/{collection}

该接口的主要目的是获取 Aptos 网络上特定 NFT Collection 的所有交易数据。通过该接口，开发者可以检索与指定 NFT Collection 相关的所有交易活动，包括购买、出售等。这可以用于监测特定 NFT Collection 的市场活动，了解该 Collection 内 NFT 的价格变化、交易情况以及持有者变更等信息。

这里检索的项目为 Aptos Monkeys，结果响应数据包含该项目下 NFT 交易的所有关键数据，如交易哈希值、区块信息、From 和 To 地址、合约地址、交易时间戳等基础数据外，还有 Token ID、交易金额和币种等 NFT 交易的特征信息。

3/Collection Statistics: /apt/statistics/collection/{collection}

该接口主要返回 Aptos 网络上一个 NFT Collection 的概览数据分析，主要包括项目名称、logo、item 总数、持有者总数、24h 最低价、24h 平均价、24h Sales、历史最高价、24h 交易额、历史总交易额等详情信息。这里我们查询的是 Aptos Monkeys 的数据信息：

可参考 Aptos NFTScan Collection：

https://aptos.nftscan.com/result/Aptos%20Monkeys

4/Trade Ranking:/apt/statistics/ranking/trade

该接口返回 Aptos 链上 NFT 热门项目的排行榜数据，提供了关于 NFT 市场中最活跃和热门交易的信息，包括查询参数包括按照时间范围(15m-1d)及排序字段（Volume/Sales）来统计每个 NFT 项目的交易总量，并返回交易量最大的 NFT 项目列表。列表中会显示每个项目的基本信息(名称/地板价/交易额等)以及关键统计数据。这些丰富的统计数据可以全面反映一个 NFT 项目的市场行情和活跃程度。

可参考 Aptos NFTScan Trading：

https://aptos.nftscan.com/ranking

构建相关 API 请求

开发者在 NFTScan 的 API 文档中找到所需的 Aptos API 接口和参数后，可以按照以下简要通用步骤使用 Python 编写 API 请求代码：

1. 导入所需的库：首先，导入必要的 Python 库，通常使用 requests 库来发送 HTTP 请求。如果 API 需要身份验证，还需要导入处理身份验证的库。

2. 构建 API 请求：构建 HTTP 请求，包括 API 的端点 URL 和任何必需的参数。确保在请求中包括所需的头部信息，如 API 密钥或其他认证凭据，如果需要的话。

3. 发送请求：使用 requests 库发送 HTTP 请求，根据 API 要求选择 GET、POST 或其他请求方法。处理响应以获得 API 返回的数据。

4. 处理 API 响应：根据 API 的响应格式，提取和处理所需的数据。通常，API 会以 JSON 格式返回数据。

5. 异常处理：在代码中添加异常处理以处理可能的网络请求错误或 API 响应问题。

这是一个基本的 Python 示例，用于调用 NFTScan 的 Aptos API，确保根据 API 文档中的具体要求和参数来自定义代码，以满足开发者的需求。

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

<!--EndFragment-->