本文介绍: 1)查询的 NFT token id 为 1,在项目中的占比为 1,协议标准erc721,Mint 的钱包地址/当前的持有者地址,被铸造时的时间戳,Mint哈希地址及价格,Token URI 的地址。此外当前地板价信息基于 NFT 市场的订单信息的集中式数据,也是通过 API 可获取的。的事件类型结果响应数据包含这笔 NFT 交易的所有关键数据,如交易哈希值、From 和 To 地址、区块信息、消耗 Gas交易时间戳等基础数据等 Mint&Sale NFT 交易事件特征信息

Starknet 是由以色列软件公司 StarkWare 开发的免许可的第 2 层网络。Starknet 作为以太坊上的 ZK Rollup 运行,帮助 dApp 使用 STARK 证明以更低的交易成本实现更大的计算规模。该网络允许智能合约区块链上部署的其他合约进行交互,从而提高协议之间的可组合性。Starknet 与 Arbitrum、OP MainnetzkSync 并列为 2023 年最受欢迎的四大 Layer 2。

就 NFTScan 数据来看,截至 12 月 1 日,Starknet 网络上已累计发行 NFT 资产 15,009,965 枚,NFT Collection 18,111 个,产生交易记录 17,009,163 条,有过交互的钱包地址 2,468,080 个,总交易额 3,245.43 ETH。

Starknet NFTScan:

怎样访问 NFTScan NFT API

在开始使用 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 永不过期,用完为止!

查 Starknet API 文档

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

NFTScan 目前拥有全网最大最全的 NFT Collection 库,已支持 Ethereum、Solana、BNBChain、Bitcoin、TON、PolygonzkSync、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 数据的需求

Starknet NFT API 模型

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

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

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

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

Starknet NFT API 检索

1/Retrieve Assets 系列

这里我们通过 Get single NFT 接口为“/v2/assets/{contract_address}/{token_id}”

检索一个合约地址下的某单个 NFT Item 的详情信息,路径参数包括 contract_address/token_id 作为选择这里我们查询的是地址 0x0727a63f78ee3f1bd18f78009067411ab369c31dece1ae22e16f567906409905 名称为 Starkpunks 且 token id 为 1 的 NFT。

点击 Try it 数据响应结果:该地址下一共返回 30 个 items,返回数据包

1)查询的 NFT token id 为 1,在项目中的占比为 1,协议标准为 erc721,Mint 的钱包地址/当前的持有者地址,被铸造时的时间戳,Mint 的哈希地址及价格,Token URI 的地址。latest_trade_price(上次成交价)/latest_trade_symbol(上次成交价的货币),latest_trade_timestamp(上次成交时间戳)当前显示 null,返还数值空,表示项目未进行过交易。

2)元数据:从该项目的元数据可以看出 Metadata 数据托管在 ipfs 上,格式image/png

3)稀有度:对属性的描述,稀有度得分以及稀有度排名。

2/ Retrieve Transactions 系列

这里我们通过 Get transactions by NFT“/v2/transactions/{contract_address}/{token_id}”这个接口,检索某单个 NFT Item 的交易记录查询参数选择交易的 NFT 事件类型(Mint/Transfer/Sale/Burn),使用 ‘;’ 分隔多个事件。同样这里我们检索 Starkpunks 且 token id 为 1 的 NFT。按照 Mint&Sale 的事件类型,结果响应数据包含这笔 NFT 交易的所有关键数据,如交易哈希值、From 和 To 地址、区块信息、消耗 Gas、交易时间戳等基础数据等 Mint&Sale NFT 交易事件特征信息。

3/ Retrieve Collection系列

这里我们通过接口 Get NFT collections by ranking

“/v2/collections/rankings 检索 Starknet 网络上 NFT Collection Ranking 榜单, 查询参数检索字段包括:

volume/sales/average_price/floor_price/volume_change/average_price_change 等,这里我们选择 volume_total 字段进行检索,共返回 100 个 data每个 data 包含 35 个 items。

4/ Collection Statistics:Collection 统计分析系列

  • 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 Statistics “/v2/statistics/collection/{contract_address}”主要返回一个 NFT Collection 的分析统计概览数据,可参考 Starknet 链上 Starkpunks 数据概览:

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 Starknet 上各与数据分析和统计有关的信息,如 Trade Ranking、Mint Amount、Gas Ranking 等这类接口允许开发者或用户查询、分析、和检索与特定数据集或指标相关的统计数据。可以用于各种用途,包括市场分析、趋势追踪、投资决策、以及了解特定数据的性质。

7/ Refresh Metadata

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

8/ Other

构建相关 NFT API 请求

调用 NFTScan 的 NFT API 对开发者极为简单。只需几个步骤,在详尽的文档中查找需要调用的接口,了解其请求方法、参数等。然后,选择一种自己熟悉的编程语言,如 JavaScript、Python 或 Java,并引入语言的请求库。并根据文档说明构造请求,配置接口请求地址、方法与请求参数。最后利用语言库发出请求,接收处理返回的 JSON 格式数据。在简单的参考文档即可完成调用过程中,开发者无需关注复杂技术细节,极低的使用门槛使获取 NFT 数据变得前所未有的容易。

这里我们请求检索 Starkpunks 合约地址下 token id 为 1 的 NFT Item 的详情信息,使用接口 Get single NFT “/v2/assets/{contract_address}/{token_id}”,检索地址为

0x0727a63f78ee3f1bd18f78009067411ab369c31dece1ae22e16f567906409905,HTTP GET 请求访问 NFTScan 的 API 端点,使用 Python 的 requests 库,可以这样构建请求:

import requests

# Define API endpoint, contract address, and token ID
api_endpoint = "https://api.nftscan.com/v2/assets"
contract_address = "0x0727a63f78ee3f1bd18f78009067411ab369c31d"
token_id = "1"

# Construct API request URL
url = f"{api_endpoint}/{contract_address}/{token_id}"

# Make an HTTP GET request
response = requests.get(url)

# Check if the request was successful
if response.status_code == 200:
    # Get the returned JSON data
    data = response.json()
    # Process the returned NFT details
    print("NFT Item Details:")
    print(data)  # This will print the retrieved NFT details, you can further process or extract information as needed
else:
    print("Request failed:", response.status_code)


About NFTScan

NFTScan 成立于 2021 年初,总部位于香港,是全球领先的 NFT 数据基础设施服务商,目前已支持 Bitcoin、Ethereum、BNBChain、Polygon、Solana、TON、Arbitrum、OptimismzkSync、Aptos 等在内的 21 条主流区块链网络。NFTScan 团队致力于为数以亿计的 Web3 用户提供简洁高效的 NFT 检索服务,为新一代金融科技公司提供安全稳定的多链 NFT 索引服务,用数据来推动 NFT 生态的繁荣发展!目前,NFTScan 在为包括 CMC、Binance NFT、Bybit、KuCoin、HashKey Group 、Mask Network、imToken、Enjin、Coin98 等在内的 5000+ 开发者提供多链 NFT 数据支持

原文地址:https://blog.csdn.net/NFT_Research/article/details/134735718

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任

如若转载,请注明出处:http://www.7code.cn/show_28636.html

如若内容造成侵权/违法违规/事实不符,请联系代码007邮箱suwngjj01@126.com进行投诉反馈,一经查实,立即删除

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注