NFTScan NFT API 一站式提供多链且海量 NFT 数据!
<!--StartFragment-->
zkSync 是由 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。
就 NFTScan 数据来看,截至 11 月 7 日,zkSync Era 网络上已累计发行 NFT 资产 16,207,719 枚,NFT Collection 78,973 个,产生交易记录 22,020,416 条,有过交互的钱包地址 2,565,626 个,总交易额 566,890.33 ETH。
zkSync NFTScan:https://zksync.nftscan.com/
怎样访问 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 永不过期,用完为止!
查看 zkSync Era 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 数据的需求。
zkSync NFT API 模型
主要包括了以下三个模型接口,包括里面一些 API 核心的字段的整体介绍和说明,方便开发者知道怎么去获取数据利用这些信息服务于自己正在构建的 Dapp 服务。
Assets API:"Assets"是 NFT 中最关键的数据字段,用于唯一标识和描述数字资产。开发者可以通过提取 zkSync Era 区块链上 NFT 的"Assets"数据来获取全面的了解,并构建相关应用。"Assets"对象提供了数字资产的唯一标识以及其整个生命周期的数据,为开发者理解和应用 NFT 提供了基础。
Transactions API:交易模型代表了区块链上一个 NFT 资产的全量交易数据,为开发者提供 NFT 的完整生命周期交易信息。包括 NFT 的 mint、转移、销售、和其他交易活动,为开发者提供了深入了解 NFT 资产在 zkSync Era 生态系统中的流动和演变过程的机会。NFTScan 不断地汇总来自各个区块链网络的 NFT 交易市场和相关交易合约信息,目前 NFTScan 已收录用于追踪和了解 NFT 市场的动态,同时也有助于开发者构建基于 NFT 的应用程序和工具。
Collections API:NFTScan 获取与 NFT Collections 相关的描述、社交媒体及其他基本信息等都链下数据。NFTScan 通过各个区块链网络中最主流的 NFT 市场提供的 API 获取这些信息。此外当前地板价信息是基于 NFT 市场的订单信息的集中式数据,也是通过 API 可获取的。
zkSync NFT API 检索
1/Retrieve Assets 系列
这里我们通过 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 详情信息。
点击 Try it,数据返回如下,主要包括该地址下持有的 eth 及 zkSync NFT 资产基础信息查询:
2/ Retrieve Transactions 系列
这里我们通过 Get transactions by account“/v2/transactions/account/{account_address}”这个接口,检索某钱包地址的 zkSync 网络上 NFT 交易记录,查询参数可选择交易的 NFT 事件类型(Mint/Transfer/Sale/Burn),使用 ';' 分隔多个事件。
同样这里我们检索 0xeb71d303a6cee4ba28e9c5adc1af308892fb681b 地址下的 NFT 交易记录。按照 Mint 的事件类型,结果响应数据包含该地址所有的 Items Mint 的所有关键数据,如交易哈希值、From 和 To 地址、区块信息、消耗 Gas、交易时间戳等基础数据等 NFT 交易的特征信息。
3/ Retrieve Collections 系列
这里我们通过接口 Get NFT collections by account “/v2/collections/own/{account_address}”检索地址为 0xeb71d303a6cee4ba28e9c5adc1af308892fb681b 持有的 NFT Collection 详情信息,返回数据包含 20 个 data:
4/ Collection Statistics:Collection 统计分析系列
这里我们通过接口 Collection Trending Statistics “/v2/statistics/collection/trending/{contract_address}”主要返回一个 NFT Collection 的 Trading 统计排序,可参考 NFTScan Trending:https://zksync.nftscan.com/0xad8a95b347b96274940229754dfd8569f2b72bf4
\
5/ Account Statistics 系列
6/ Analytic Statistics 系列
该系列接口通常用于获取 NFTScan zkSync Era 网络上各与数据分析和统计有关的信息,如 Trade Ranking、Mint Amount 等这类接口允许开发者或用户查询、分析、和检索与特定数据集或指标相关的统计数据。可以用于各种用途,包括市场分析、趋势追踪、投资决策、以及了解特定数据的性质。
参考:https://zksync.nftscan.com/analytics
7/ Refresh Metadata
Refresh Metadata 这类接口可以帮助开发者或用户提交后台刷新元数据任务,该任务审核后会刷新提交的指定 Item 或整个合约元数据。
8/ Other
构建相关 NFT API 请求
构建 NFTScan 相关 NFT 数据请求非常简单方便,开发者只需要在 API 文档中找到所需的接口,查看接口地址、请求方法、请求参数等说明。然后根据自身需求选择编程语言,如 JavaScript、Python、Java 等,使用该语言的 HTTP 请求库向接口地址发送构造好的请求,筛选必要的头信息和参数。整个调用过程快速便捷,开发者可以完全根据文档说明来实施。
例如,我们请求 0xeb71d303a6cee4ba28e9c5adc1af308892fb681b 持有的 NFT Collection 详情信息,使用接口:“/v2/collections/own/{account_address}”,HTTP GET 请求访问 NFTScan 的 API 端点,使用 Python 的 requests 库,可以这样构建请求:
import requests
# Define the API URL with address parameterapi_url = "https://api.nftscan.com/v2/collections/own/0xeb71d303a6cee4ba28e9c5adc1af308892fb681b"
# Send GET requestresponse = requests.get(api_url)
# Check status code if response.status_code == 200:
# Request succeeded, print response data data = response.json() print(data) else: # Request failed print("Request failed with status code:", response.status_code)
主要步骤包括:构造 API 接口 URL,并填入 account_address 参数,使用 requests 库发送 GET 请求;检查返回状态码,200 表示调用成功;请求成功就可以处理返回的 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 数据服务!
<!--EndFragment-->
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!