PlatON 是由萬向區(qū)塊鏈和矩陣元主導(dǎo)開發(fā)的面向下一代的全球計算架構(gòu)，創(chuàng)新性的采用元計算框架 Monad 和基于 Reload 覆蓋網(wǎng)絡(luò)的同構(gòu)多鏈架構(gòu)，其愿景是成為全球首個提供完備隱私保護能力的運營服務(wù)網(wǎng)絡(luò)。它提供計算、存儲、通訊服務(wù)，并提供算力、算法、數(shù)據(jù)等眾多基礎(chǔ)資源以及公共基礎(chǔ)設(shè)施軟件開發(fā)、咨詢及運營服務(wù)等。

就 NFTScan 數(shù)據(jù)來看，截至 1 月 5 日，PlatON 網(wǎng)絡(luò)上已累計發(fā)行 NFT 資產(chǎn) 2,710,774 枚，NFT Collection 2,261 個，產(chǎn)生交互記錄 6,865,324 條，有過交互的錢包地址 1,180,646 個，總交易額 190,295.2 LAT。

PlatON NFTScan：

創(chuàng)建?NFTScan 開發(fā)者賬號

在開始使用 NFTScan API 之前，首先需要訪問開發(fā)者網(wǎng)站并創(chuàng)建一個賬戶。前往 NFTScan 官方網(wǎng)站點擊 NFTScan API “Sign Up”按鈕進行注冊。

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

登錄后在 Dashboard（面板）上找到自己獨有的 API KAY，將其復(fù)制。訪問 API 文檔，將自己的 API KEY 輸進 API 文檔的相應(yīng)位置。根據(jù)文檔的指引，就可以開始使用 API 服務(wù)了。在 API 文檔中，開發(fā)者可以找到多種可供選擇的接口模式，根據(jù)需求來選擇最合適的接口。

在 Dashboard 中，開發(fā)人員還可以查看自己 API 使用情況的統(tǒng)計數(shù)據(jù)，幫助記錄歷史使用數(shù)據(jù)。不僅如此，NFTScan 還為每位注冊開發(fā)者提供 1M CU 的 API 調(diào)用服務(wù)，用于請求所有的 NFT API 接口，并且 CU 永不過期，用完為止！

查看?PlatON?NFT API 文檔

在成功注冊開發(fā)者賬號獲取 API Key 后，需要查看 NFTScan API 文檔。API 文檔包含了所有可以使用的 API 端點和參數(shù)，以及如何構(gòu)建請求和處理響應(yīng)的詳細信息。請認真閱讀 API 文檔，并確保理解如何使用 API 來獲取您需要的數(shù)據(jù)。NFTScan API 服務(wù)致力于幫助開發(fā)者改善獲取 NFT 數(shù)據(jù)分析體驗。

NFTScan 目前擁有全網(wǎng)最大最全的 NFT Collection 庫，已支持 Ethereum、Solana、BNBChain、Bitcoin、TON、Polygon、zkSync、Aptos、Linea、Base、Avalanche、Arbitrum、OP Mainnet、Starknet、Scroll、Viction、Fantom、Moonbeam、PlatON、Cronos、Gnosis?21?條區(qū)塊鏈的?NFT 全量數(shù)據(jù)，所涵蓋的 NFT 數(shù)據(jù)全、種類豐富，提供一整套的接口來獲得 ERC721 和 ERC1155 資產(chǎn)以及交易、項目、市場統(tǒng)計等信息，現(xiàn)在支持 60 多個針對 EVM 兼容鏈的公共接口，以及針對 Solana、Aptos、Bitcoin、TON 的一批相同模型的接口，很大程度上滿足了開發(fā)者索引多種類型的 NFT?數(shù)據(jù)的需求。

PlatON?NFT API 模型

主要包括了以下三個模型接口，包括里面一些 API 核心的字段的整體介紹和說明，方便開發(fā)者知道怎么去獲取數(shù)據(jù)利用這些信息服務(wù)于自己正在構(gòu)建的 Dapp 服務(wù)。

Assets API："Assets"是 NFT 中最關(guān)鍵的數(shù)據(jù)字段，用于唯一標識和描述數(shù)字資產(chǎn)。開發(fā)者可以通過提取?PlatON?區(qū)塊鏈上 NFT 的"Assets"數(shù)據(jù)來獲取全面的了解，并構(gòu)建相關(guān)應(yīng)用。"Assets"對象提供了數(shù)字資產(chǎn)的唯一標識以及其整個生命周期的數(shù)據(jù)，為開發(fā)者理解和應(yīng)用 NFT 提供了基礎(chǔ)。

Transactions API：交易模型代表了區(qū)塊鏈上一個 NFT 資產(chǎn)的全量交易數(shù)據(jù)，為開發(fā)者提供 NFT 的完整生命周期交易信息。包括 NFT 的 mint、轉(zhuǎn)移、銷售、和其他交易活動，為開發(fā)者提供了深入了解 NFT 資產(chǎn)在?PlatON?生態(tài)系統(tǒng)中的流動和演變過程的機會。NFTScan 不斷地匯總來自各個區(qū)塊鏈網(wǎng)絡(luò)的 NFT 交易市場和相關(guān)交易合約信息，目前 NFTScan 已收錄用于追蹤和了解 NFT 市場的動態(tài)，同時也有助于開發(fā)者構(gòu)建基于 NFT 的應(yīng)用程序和工具。

Collections API：NFTScan 獲取與 NFT Collections 相關(guān)的描述、社交媒體及其他基本信息等鏈下數(shù)據(jù)。NFTScan 通過各個區(qū)塊鏈網(wǎng)絡(luò)中最主流的 NFT 市場提供的 API 獲取這些信息。此外當前地板價信息是基于 NFT 市場的訂單信息的集中式數(shù)據(jù)，也是通過 API 可獲取的。

PlatON?NFT API 檢索

1/Retrieve Assets 系列

• Get NFTs by account（通過錢包地址檢索 NFT）

• Get all NFTs by account（檢索錢包地址的所有 NFT，并根據(jù)合約地址對 NFT 進行分組，如果賬戶地址擁有的 NFT 總數(shù)超過 2000 個，則返回的 NFT 將限制在 2000 個以下。在這種情況下，開發(fā)者和用戶可以通過分頁查詢請求按賬戶獲取該賬戶地址擁有的所有 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（該接口通過在請求正文中應(yīng)用搜索篩選器來返回 NFT 資產(chǎn)列表。資產(chǎn)按 nftscan_id 升序排序）

• Get NFTs by attributes（該接口返回一組屬于具有屬性的 NFT 合約地址的 NFT，NFT 按 token_id 升序排序）

• Get all multi-chain NFTs by account（該接口返回賬戶地址擁有的所有多鏈 NFT，NFT 根據(jù)合約地址進行分組）

這里我們通過接口?Get all NFTs by account?"/v2/account/own/all/{account_address}"?來檢索某個?PlatON 錢包地址內(nèi)持有的全量 NFT，查詢參數(shù)包括協(xié)議標準：erc721/erc1155；排序字段：mint_time/own_time/last_trade_price（僅適用于 erc721）。我們這里請求的是地址：lat1cghxn3j8j4h7sxw0rey9jzc9388tp7aede4870 PlatON 鏈上所有的 erc721 協(xié)議的 NFT。

點擊 Try it 數(shù)據(jù)響應(yīng)結(jié)果：該地址下一共持有 3?個 NFT Collections，分別是?PlatON Ecosystem Rabbit?Red Packets、SA NFT、HashKey DID，按 floor_price 降序排序，返回數(shù)據(jù)包括每個?NFT contract 地址以及 name，持有數(shù)量及該 contract 地址下 item 數(shù)量，地板價以及一些的基礎(chǔ)細節(jié)信息描述等等。

2/ Retrieve Transactions?系列

• Get transactions by account（該接口返回錢包地址的 NFT 交易列表）

• Get transactions by contract（該接口返回?NFT 合約地址的 NFT 交易列表）

• Get transactions by NFT（該接口返回單個 NFT 的 NFT 交易列表）

• Search transactions（該接口返回在請求正文中應(yīng)用搜索過濾器來返回 NFT 交易列表）

• Get transactions by to address（該接口返回按交易參數(shù)過濾的 NFT 交易列表）

• Get transactions by hash（該接口返回根據(jù)交易哈希列表查詢到的交易記錄）

這里我們通過?Get transactions by account?"/v2/transactions/account/{account_address}"?這個接口，檢索某錢包地址在?PlatON 網(wǎng)絡(luò)上?NFT 交易記錄，查詢參數(shù)可選擇交易的 NFT 事件類型（Mint/Transfer/Sale/Burn），使用 ';' 分隔多個事件。

同樣這里我們檢索?lat1cghxn3j8j4h7sxw0rey9jzc9388tp7aede4870 地址下的 NFT 交易記錄。按照 Mint 的事件類型，結(jié)果響應(yīng)數(shù)據(jù)包含該地址所有的 Items Mint 的所有關(guān)鍵數(shù)據(jù)，如交易哈希值、From?和 To 地址、區(qū)塊信息、消耗 Gas、交易時間戳等基礎(chǔ)數(shù)據(jù)等 NFT 交易的特征信息。

3/?Retrieve Collections?系列

• Get an NFT collection（根據(jù) Collection 的合約地址查詢詳情，包括概覽及按照描述對 Item 進行分類，持有者分布、平均價格、地板價等基本概括信息）

• Search NFT collections（此接口通過在請求正文中應(yīng)用搜索過濾器來返回 Collection 列表的信息，Collection 按部署塊編號升序排序）

• Get NFT collections by account（該接口返回具有給定賬戶地址的項目列表信息，Collection 按地板價從高到低排序）

• Get NFT collections by ranking（該接口返回具有給定排序字段的項目列表信息，Collection?按給定的排序字段和給定的排序方向排序）

這里我們通過接口?Get an NFT collection“/v2/collections/{contract_address}”檢索合約地址為?lat1qjwjv237chk0nhv7xevumjf0g3wtcm73hqv9al?Name 為?Plato_World?的?NFT?Collection 詳情信息，返回的每條數(shù)據(jù)包含 32 個 data：

4/ Collection Statistics：Collection 統(tǒng)計分析系列

• Collection Statistics（該接口提供 NFT Collection 的分析統(tǒng)計概覽數(shù)據(jù)）

• Collection Trade Distribution（該接口主要提供項目交易分布）

• Collection Trending Statistics（主要返回一個項目的 Trading 統(tǒng)計排序）

• Collection Holding Amount Distribution（該接口可返回 NFT 項目持有量的分布信息）

• Collection Holding Period Distribution（數(shù)據(jù)返回?NFT 項目持有期分布信息）

• Collection Blue Chip Statistics（藍籌項目統(tǒng)計概覽數(shù)據(jù)）

• Collection Blue Chip List（該項目涉及的藍籌項目清單，可參考 NFTScan Blue Chip Collection）

• Collection Top Holder（該 Collection 的頂級持有者分布）

這里我們通過接口?Collection Holding Period Distribution?"/v2/statistics/period/distribution/{contract_address}"主要返回一個 NFT Collection 的持有期分布信息，可參考?PlatON 鏈上?NFTScan?Holding Period Distribution：

5/?Account Statistics?系列

• Account Overview Statistics（該接口返回賬戶地址的概覽統(tǒng)計信息，參考 NFTScan?Overview）

• Account Holding Distribution（該接口返回賬戶地址的 NFT 持有分布統(tǒng)計信息，參考?NFTScan Portfolio）

• Account Holding NFT Trending（該接口返回賬戶地址的 NFT 持有量（或數(shù)量）統(tǒng)計信息，參考 NFTScan Portfolio）

6/?Analytic Statistics 系列

該系列接口通常用于獲取 NFTScan PlatON?上各與數(shù)據(jù)分析和統(tǒng)計有關(guān)的信息，如 Trade Ranking、Mint Amount、Gas Ranking 等這類接口允許開發(fā)者或用戶查詢、分析、和檢索與特定數(shù)據(jù)集或指標相關(guān)的統(tǒng)計數(shù)據(jù)?？梢杂糜诟鞣N用途，包括市場分析、趨勢追蹤、投資決策、以及了解特定數(shù)據(jù)的性質(zhì)。

參考：

7/?Refresh Metadata

• Refresh NFT metadata

• Refresh NFT metadata by contract

Refresh Metadata?這類接口可以幫助開發(fā)者或用戶提交后臺刷新元數(shù)據(jù)任務(wù)，該任務(wù)審核后會刷新提交的指定?Item 或整個合約元數(shù)據(jù)。

8/ Other

• Get latest block number（返回 NFTScan 已到達的最新塊號）

• Get NFT amount by account（根據(jù)請求體中的搜索列表返回賬戶地址擁有的 ERC721 和 ERC1155 NFT 數(shù)量信息）

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

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

構(gòu)建相關(guān) NFT?API 請求

當開發(fā)者在 NFTScan 的 API 文檔中找到所需的 PlatON API 接口和參數(shù)后，可以使用他們選擇的編程語言（例如 Python、Java、JavaScript 等）來編寫 API 請求代碼。以下是一個示例，演示如何使用 Python 來請求一個錢包地址持有的 NFT。

例如，我們請求?lat1cghxn3j8j4h7sxw0rey9jzc9388tp7aede4870?持有的 NFT?詳情信息，HTTP GET 請求接口“v2/account/own/{account_address}”，使用 Python 的 requests 庫，可以這樣構(gòu)建請求：

import requests# Define NFTScan API endpoint and account address
api_endpoint = "https://api.nftscan.com/v2/account/own"
account_address = "lat1cghxn3j8j4h7sxw0rey9jzc9388tp7aede4870"# Construct API request URL
url = f"{api_endpoint}/{account_address}"# Make an HTTP GET request
response = requests.get(url)# Check if the request was successful
if response.status_code == 200:# Get the returned JSON datadata = response.json()# Process the returned NFT detailsprint("Owner's NFT 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)

運行代碼后，開發(fā)者將獲得該地址持有的 NFT 詳情信息，并可以根據(jù)需要進一步處理或提取信息。

---

About NFTScan

NFTScan 成立于 2021 年初，總部位于香港，是全球領(lǐng)先的 NFT 數(shù)據(jù)基礎(chǔ)設(shè)施服務(wù)商，目前已支持 Bitcoin、Ethereum、BNBChain、Polygon、Solana、TON、Arbitrum、Optimism、zkSync、Aptos 等在內(nèi)的 21 條主流區(qū)塊鏈網(wǎng)絡(luò)。NFTScan 團隊致力于為數(shù)以億計的 Web3 用戶提供簡潔高效的 NFT 檢索服務(wù)，為新一代金融科技公司提供安全穩(wěn)定的多鏈 NFT 索引服務(wù)，用數(shù)據(jù)來推動 NFT 生態(tài)的繁榮發(fā)展！目前，NFTScan 在為包括 CMC、Binance NFT、Bybit、KuCoin、HashKey Group 、Mask Network、imToken、Enjin、Coin98 等在內(nèi)的 5000+ 開發(fā)者提供多鏈 NFT 數(shù)據(jù)支持！