如何應用 NFTScan NFT API 在 Aptos 網絡上开發 Web3 應用

2023-10-28 00:10:23

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:

目前除了兼容 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”按鈕進行注冊。

登錄後在 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：

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

該接口返回 Aptos 鏈上 NFT 熱門項目的排行榜數據，提供了關於 NFT 市場中最活躍和熱門交易的信息，包括查詢參數包括按照時間範圍(15m-1d)及排序字段（Volume/Sales）來統計每個 NFT 項目的交易總量，並返回交易量最大的 NFT 項目列表。列表中會顯示每個項目的基本信息(名稱/地板價/交易額等)以及關鍵統計數據。這些豐富的統計數據可以全面反映一個 NFT 項目的市場行情和活躍程度。

可參考 Aptos NFTScan Trading：

構建相關 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 數據服務！