NFTScan 开发者平台更新了 Mint Blockchain 的 NFT API 数据服务,包括对外开放的多个 API 查询接口。
Mint Blockchain 是一个基于 OP Stack 构建的 L2 区块链,聚焦在 NFT 领域的创新型 L2 网络,致力于促进 NFT 资产协议标准的创新和现实商业场景中 NFT 资产的大规模采用。Mint Blockchain 的底层账本安全是完全基于以太坊网络安全共识构建的。同时作为 L2 网络,是一个完全兼容 EVM 的公共区块链网络,以太坊生态的开发者可以无缝将项目扩展到 Mint Blockchain 网络上来,为以太坊生态提供了有效的可扩展性。
根据 NFTScan 数据显示,截至 5 月 23日,Mint Blockchain 上已累计发行 NFT 资产 387,477枚,NFTContract37个,产生交互记录388,471条,有过交互的钱包地址381,141个,总交易额0.22ETH。
创建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 永不过期,用完为止!
查看**MintNFT A**PI 文档
在成功注册开发者账号获取 API Key 后,需要查看 NFTScan API 文档。API 文档包含了所有可以使用的 API 端点和参数,以及如何构建请求和处理响应的详细信息。请认真阅读 API 文档,并确保理解如何使用 API 来获取您需要的数据。NFTScan API 服务致力于帮助开发者改善获取 NFT 数据分析体验。
NFTScan 目前拥有全网最大最全的 NFT Collection 库,已支持 Ethereum、Solana、BNBChain、Bitcoin、Mint Blockchain 等在内25条区块链的NFT 全量数据,所涵盖的 NFT 数据全、种类丰富,提供一整套的接口来获得 ERC721 和 ERC1155 资产以及交易、项目、市场统计等信息,现在支持 60 多个针对 EVM 兼容链的公共接口,以及针对 Solana、Aptos、Bitcoin、TON 的一批相同模型的接口,很大程度上满足了开发者索引多种类型的 NFT数据的需求。
MintNF**T API 模型**
主要包括了以下三个模型接口,包括里面一些 API 核心的字段的整体介绍和说明,方便开发者知道怎么去获取数据利用这些信息服务于自己正在构建的 Dapp 服务。
Assets API:"Assets"是 NFT 中最关键的数据字段,用于唯一标识和描述数字资产。开发者可以通过提取MintBlockchain上 NFT 的"Assets"数据来获取全面的了解,并构建相关应用。"Assets"对象提供了数字资产的唯一标识以及其整个生命周期的数据,为开发者理解和应用 NFT 提供了基础。
Transactions API:交易模型代表了区块链上一个 NFT 资产的全量交易数据,为开发者提供 NFT 的完整生命周期交易信息。包括 NFT 的铸造、转移、销售、和其他交易活动,为开发者提供了深入了解 NFT 资产在Mint生态系统中的流动和演变过程的机会。NFTScan 不断地汇总来自各个区块链网络的 NFT 交易市场和相关交易合约信息,目前 NFTScan 已收录用于追踪和了解 NFT 市场的动态,同时也有助于开发者构建基于 NFT 的应用程序和工具。
Collections API:NFTScan 获取与 NFT Collections 相关的描述、社交媒体及其他基本信息等链下数据。NFTScan 通过各个区块链网络中最主流的 NFT 市场提供的 API 获取这些信息。此外当前地板价信息是基于 NFT 市场的订单信息的集中式数据,也是通过 API 可获取的。
1/ Retrieve Assets 系列
这里我们通过Get NFTs by contract接口为“/v2/assets/{contract_address}”来检索一个合约地址下 NFT 的详情信息,路径参数包括contract_address作为选择,这里我们查询的是合约地址0x776fcec07e65dc03e35a9585f9194b8a9082cddb,名称为 GreenID的详细数据。
点击 Try it,数据返回如下,数据响应结果显示该 NFT Collection 所有item 的基础数据及元数据信息,这里我们选择的GreenID,可以看到当前项目下一共 374248个 Items,返回数据按照 token_id 进行排序,例如 id 为 1的 item:
1)单个 item 基础数据:
0x776fcec07e65dc03e35a9585f9194b8a9082cddb及名称 GreenID,这里查询的 NFT Token id 为 1,在项目中的占比为 1,协议标准为 erc721,铸造时的钱包地址/持有者钱包地址,被铸造时的时间戳/Mint 的哈希地址/Token URI 的地址。latest_trade_price(上次成交价)/latest_trade_symbol(上次成交价的货币),latest_trade_timestamp(上次成交时间戳)等数据。
2)元数据:从该项目的元数据可以看出 Metadata 数据托管在 ipfs 上,token_uri:https\://www.mintchain.io/api/tree/metadata/1,格式为 image/png,存储路径以及为对该图片的细节特征描述。
3)稀有度描述:得分及综合稀有度排名。
2/ Retrieve Transactions 系列
这里我们通过 Get transactions by NFT“/v2/transactions/{contract_address}/{token_id}”这个接口,检索某NFT 合约地址的下单个NFT 交易记录,查询参数可选择交易的 NFT 事件类型(Mint/Transfer/Sale/Burn),使用 ';' 分隔多个事件。
同样这里我们检索Mint Commemorative NFTtokenID 为 1 的NFT 交易记录。按照 Mint/Transfer/Sale/Burn 选择所有事件类型,结果响应数据包含这个 NFT Item 下所有交易关键数据,如交易哈希值、From 和 To 地址、区块信息、消耗 Gas、交易时间戳等基础数据等 NFT 交易的特征信息。数据返回显示该 item 目前只有一条 Mint 相关交易记录。
3/Retrieve Collections系列
这里我们通过接口Getan NFT collection“/v2/collections/{contract_address}”检索地址为0x776fcec07e65dc03e35a9585f9194b8a9082cddb 名称为GreenID的详情信息:
4/ Collection Statistics:Collection 统计分析系列
这里我们通过接口 Collection Top Holder “/v2/statistics/collection/holder/{contract_address}”主要返回一个 NFT Collection 下的持有量分布,可参考 NFTScan Holders:
5/Account Statistics系列
6/Analytic Statistics 系列
该系列接口通常用于获取 NFTScanMint Blockchain 上各与数据分析和统计有关的信息,如 Trade Ranking、Mint Amount 等等这类接口允许开发者或用户查询、分析、和检索与特定数据集或指标相关的统计数据。可以用于各种用途,包括市场分析、趋势追踪、投资决策、以及了解特定数据的性质。
7/Refresh Metadata
Refresh Metadata这类接口可以帮助开发者或用户提交后台刷新元数据任务,该任务审核后会刷新提交的指定Item 或整个合约元数据,以及反馈垃圾诈骗合约地址。
8/ Other
构建相关 NFTAPI 请求
构建 NFTScan 相关的 NFT 数据请求非常简单便捷。开发者只需要浏览 API 文档找到所需的接口,了解接口地址、请求方法、请求参数等信息。然后根据个人需求选择编程语言,比如 JavaScript、Python、Java 等,使用该语言的 HTTP 请求库发送构建好的请求到接口地址,编写代码时,开发者只需组织好接口参数,如合约地址、API Key 等,调用对应的 NFTScan 接口,就可以方便地获取到标准化的 JSON 格式数据。
这里我们使用接口Get an NFT collection“/v2/collections/{contract_address}
”对 MintBlockchain 上的GreenID该项目的详情数据进行调取,地址为
0x776fcec07e65dc03e35a9585f9194b8a9082cddb,HTTP GET 请求访问 NFTScan 的 API 接口,使用 Python 的 requests 库,可以这样构建请求:
import requests
def get_nft_collection_details(contract_address, api_key):
base_url = "https://api.nftscan.com/v2/collections/"
url = f"{base_url}{contract_address}"
headers = {
"Content-Type": "application/json",
"x-api-key": api_key
}
response = requests.get(url, headers=headers)
if response.status_code == 200:
return response.json()
else:
return {"error": f"Failed to retrieve data: {response.status_code}"}
# Example usage
contract_address = "0x776fcec07e65dc03e35a9585f9194b8a9082cddb"
api_key = "your_api_key_here"
nft_details = get_nft_collection_details(contract_address, api_key)
print(nft_details)
导入 requests 库:使用import requests导入所需的库。
定义函数get_nft_collection_details:
contract_address:NFT 合约地址。
构建 URL:将基础 URL 与contract_address进行拼接。
设置请求头:包括Content-Type和x-api-key,后者用于身份验证。
发送请求:使用requests.get发送 GET 请求。
处理响应:
此代码仅为示例,开发者需要参考实际应用进行构建,请确保将 your_api_key_here 替换为实际的 API Key。
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!