指南：通過 NFTScan API 獲取錢包地址的 NFT Statistics 全量數據

2023-09-28 16:09:30

獲取錢包地址的全量 NFT 及統計分析數據對於开發者和投資者來說都是十分重要的。具體來說：對开發者而言，獲取每個錢包的完整資產數據，並進行統計分析，是構建錢包管理工具、資產分析應用的基礎，這些應用都需要全面且精確地反映每個錢包的資產配置情況。對投資者而言，統計分析錢包的資產數據，可以洞察重要账戶的資產結構、交易模式等信息，對做出投資決策至關重要。這些數據正確地表示每個錢包地址的全量資產情況，是开發與投資不可或缺的重要基礎，為 NFT 生態系統的參與者提供了不可或缺的見解和支持。數據的透明性和可信度還有助於增強市場的信任和合作，推動 NFT 領域的創新和發展。

根據 NFTScan 數據顯示，截止目前 9 月 28 日以太坊上一共產生了枚 147,965,427 NFT 資產，256,154,198 條鏈上記錄，10,199,868 個有過交互的錢包地址。

傳統上，獲取和分析這些全量的數據需要大量手動工作，現在开發者和投資者可以通過調用相關的統計類接口，以編程方式獲取每個錢包的資產統計數據，包括多鏈 NFT、持倉價值等。NFTScan 提供了 Account Statistics 類接口，極大地幫助开發者輕松獲取各錢包地址的數字資產統計數據，簡化並優化對鏈上數據的獲取和分析工作，為構建錢包分析、資產管理等應用提供了堅實基礎，也使得基於鏈上數據的研究和投資決策變得更高效。

怎樣訪問 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 永不過期，用完為止！

查看 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、Fantom、Moonbeam、PlatON、Cronos、Gnosis 18 條區塊鏈的 NFT 全量數據，所涵蓋的 NFT 數據全、種類豐富，提供一整套的接口來獲得 ERC721 和 ERC1155 資產以及交易、項目、市場統計等信息，現在支持 50 多個針對 EVM 兼容鏈的公共接口，以及針對 Solana、Aptos、Bitcoin 的一批相同模型的接口，很大程度上滿足了开發者索引多種類型的 NFT 數據的需求。

檢索 Account Statistics 數據相關 API

1）Account Overview Statistics：/v2/statistics/overview/{account_address}

該 API 允許开發者以程序化方式獲取指定以太坊錢包地址的數字資產統計總覽數據。开發者只需要輸入想查詢的錢包地址，該 API 就可以返回該地址的 NFT 等多鏈資產的持有數量、具體持倉項目、總體價值分布、近期交易活動概覽等多維度統計信息，資產配置的數據可以全面反映一個錢包地址的資產概況，直接調用該 API 就可以獲得完整的錢包資產統計分析，該 API 為構建錢包管理、資產數據分析、投資決策支持等應用提供了重要的數據接口。

可參考 NFT Account Overview：

开發者可以通過右上方 EVM 多鏈選擇錢包地址，這裏我們選擇以太坊巨鯨地址作為示例：

0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813，輸入自己的 api-key，點擊 Try it，數據返回顯示 16 個 data：

"持有價值": 821.9923 ETH

"买入價值": 212.81 ETH

"賣出價值": 669.24 ETH

"gas 消耗": 0.9 ETH

"持有價值 usdt": 1306877.34

"买入價值 usdt": 338344.49

"賣出價值 usdt": 1064017.98

"gas 消耗 usdt": 1430.9

"持有數量": 652

"mint 數量": 291

"买入數量": 8

"售出數量": 70

"發送數量": 105

"接收數量": 645

"銷毀數量": 23

"持有 collection 數量": 360

2）Account Holding Distribution：/v2/statistics/distribution/{account_address}

該接口返回账戶地址的 NFT 持有分布統計信息，开發者通過調用該接口並傳入账戶地址參數，可以獲取該账戶地址當前持有的所有 NFT 詳情分布情況。包括持倉資產的總數量，以及按照 NFT Collection 劃分資產數量、總價值等統計數據，無需开發者處理鏈上數據，為構建資產分析和投資組合管理應用提供了重要的數據支持。詳情可參考 NFTScan Portfolio，路徑參數這裏選擇了0x020ca66c30bec2c4fe3861a94e4db4a498a35872 該地址，查詢參數包括 volume/amount，分別返回按照交易量和數量的持有 NFT 統計分布數據。

返回數據包括以下：

—"合約地址":

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

"項目名稱":" BoredApeYachtClub"

"持有價值": 3513.51 ETH

"持有佔比":"71.97%"

—"合約地址":

"0xc73b17179bf0c59cd5860bb25247d1d1092c1088"

"項目名稱":"QQL Mint Pass"

"持有價值": 682.5 ETH

"持有佔比": "13.98%"

—"合約地址":

"0x60e4d786628fea6478f785a6d7e704777c86a7c6"

"項目名稱": "MutantApeYachtClub"

"持有價值": 368.6 ETH

"持有佔比": "7.55%"

—"合約地址":

"0x3c6fbc94288f5af5201085948ddb18aded2e6879"

"項目名稱": "DeFiApes"

"持有價值": 195.795 ETH

"持有佔比": "4.01%"

—"合約地址":

"0x7a63d17f5a59bca04b6702f461b1f1a1c59b100b"

"項目名稱":

"Winds of Yawanawa by Yawanawa and Refik Anadol"

"持有價值": 43.75 ETH

"持有佔比": "0.9%"

—"合約地址": NULL

"項目名稱": "other"

"持有價值": 77.82 ETH

"持有佔比": "1.59%"

構建相關 NFT 請求

當开發者在 NFTScan 的 API 文檔中查找到 Account Statistics 相關的接口和參數後，可以使用自己熟悉的編程語言(如 Python、Java、JavaScript 等)來調用這些接口，編寫獲取账戶統計數據的 API 請求代碼，开發者可以方便地組織接口參數，發起請求並處理返回的數據。

NFTScan 的 SDK 庫還提供了對智能合約的無縫部署和通過 NFTScan API 調用常見合約定義的方法和功能，消除了开發者需要掌握 Solidity、編譯代碼或導入 ABI 的需求。通過使用 SDK，开發者可以輕松地在支持的網絡上使用 JavaScript 執行調用操作。此外，SDK 還明確了標准的讀取和寫入方法，其中讀取方法可以通過交互式 REST API 進行試用。

例如這裏通過 /v2/statistics/distribution/{account_address} 接口請求一個地址的 NFT 詳情分布情況。

步驟 1：導入必要的庫和模塊

首先，需要導入必要的庫和模塊，以便在代碼中發起 HTTP 請求並處理響應數據。在 Python 中，你可以使用 requests 庫來完成這些任務。確保已安裝該庫，如果沒有，可以使用 pip install requests 來安裝。

步驟 2：設置 API 請求的基本信息

在這一步需要設置 API 請求的基本信息，包括 API 的根 URL 和所需的參數。在這裏，將替換 {account_address} 參數為想要查詢的錢包地址。

步驟 3：構建 API 請求

使用 requests 庫構建 API 請求。這通常包括指定 HTTP 請求的類型（GET、POST 等）和請求頭（如果需要）。在這裏，我們將發起一個 GET 請求。

步驟 4：處理 API 響應

最後，需要處理 API 響應的數據。通常，API 會以 JSON 格式返回數據，开發者可以使用 Python 的內置 JSON 解析器來解析響應。

這就是一個使用 Python 來發起 NFTScan Account Holding Distribution API 請求的基本示例。請注意，开發者可以根據需要添加錯誤處理和數據處理的邏輯，以滿足具體需求。

最後，NFTScan 的目標是為开發者提供簡化優化的數據接口，加快他們在 NFT 領域的應用开發和創新速度。通過提供高質量、一致性和可靠性的 NFT 數據，NFTScan 使开發者能夠更快速地構建應用程序，同時也減輕了他們解析和處理 NFT 原始數據的負擔。給开發者帶來很大便利，使其無需重復开發獲取和處理 NFT 數據的基礎功能，能更加專注在應用創新和核心業務邏輯的开發上。NFTScan 為开發者提供可靠的數據基礎設施支持，是开發者構建 NFT 應用的重要助力。

About NFTScan

NFTScan 成立於 2021 年 4 月份，總部位於中國香港，是全球領先的 NFT 數據基礎設施服務商，目前已支持 Bitcoin、Ethereum、BNBChain、Polygon、Solana、Linea、Arbitrum、Optimism、zkSync、Aptos 等在內的 18 條主流區塊鏈網絡。NFTScan 團隊致力於為數以億計的 Web3 用戶提供簡潔高效的 NFT 檢索服務，為新一代金融科技公司提供安全穩定的多鏈 NFT 索引服務，用數據來推動 NFT 生態的繁榮發展！目前，NFTScan 在為包括 CMC、Binance NFT、Bybit Web3、KuCoin、HashKey Group 、SafePal、Mask、imToken、Enjin、Coin98、OneKey、TokenPocket、AlienSwap 等在內的 4000+ 开發者提供多鏈 NFT 數據支持！