指南：如何使用 NFTScan API 獲取 NFT Collection 全量數據

2023-09-01 16:09:51

獲取完整和准確的 NFT Collection 全面數據對於开發者來說極為重要，不僅提供全面的洞察並支撐各種創新應用，還提供詳細的數據能呈現出 Collection 的整體發展趨勢，同時豐富的歷史數據能夠剖析其價值增長情況，判斷未來潛力。

不同時間段的交易和活躍度進行對比不僅可以發現交易機會，其中 NFT Collection 持有者信息更能支持對用戶群體進行劃分，實施精准營銷；除此之外，全面的數據支撐可視化呈現，豐富應用的展示內容和用戶體驗。利用強大的 NFT API，开發者可以基於海量數據進行建模和預測，制定智能投資策略。可以說，獲取完整、准確的 NFT Collection 數據，對於开發者研究 NFT 市場，進行數據驅動決策，以及开發創新應用都具有重要價值。

就 Ethereum NFTScan 數據來看，目前以太坊上共產生：NFT 合約數量 259,229；NFT 資產數量 146,341,468；NFT 鏈上記錄數量 252,387,389；NFT 交互錢包地址數量 9,828,744。

當前开發者獲取 NFT Collection 數據面臨分散、不完整、難以識別等痛點，手動收集成本高且無法滿足產品化海量數據需求，這給开發者的檢索帶來了很大難度。不同鏈上資產數不勝數，僅僅依靠合約地址無法有效區分，這些種種因素導致开發者很難快速定位到需要的 Collection 獲得准確的信息。

通過 NFTScan NFT API 豐富的過濾條件，可以按多鏈、合約地址、錢包地址等多維度進行組合篩選，幫助开發者精准定位目標 NFT Collection，獲取該項目的全量數據。相比於分散查找，通過 NFTScan API 一個請求即可獲得標准化的完整數據，極大地提升了开發效率。开發者可以快速找到自己需要的 Collection 數據，無需逐個解析不同來源的信息，合約數據無需自行抓取，整個獲取流程簡單高效，既節省了時間成本，也減少了开發工作量。可以說 NFTScan 的 NFT API 條件檢索功能，使开發者獲取 Collection 數據變得輕松順暢，能夠有效支持开發者構建 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 永不過期，用完為止！

查看 NFT API 文檔

在成功注冊开發者账號獲取 API Key 後，您需要查看 NFTScan API 文檔。API 文檔包含了所有可以使用的 API 端點和參數，以及如何構建請求和處理響應的詳細信息。請認真閱讀 API 文檔，並確保理解如何使用 API 來獲取您需要的數據。NFTScan API 服務致力於幫助开發者改善獲取 NFT 數據分析體驗。

NFTScan 目前擁有全網最大最全的 NFT Collection 庫，已支持 Ethereum、Solana、BNBChain、Bitcoin、Polygon、zkSync、Aptos、Linea、Base、Avalanche、Arbitrum、Optimism、Fantom、Moonbeam、PlatON、Cronos、Gnosis 17 條區塊鏈的 NFT 全量數據，所涵蓋的 NFT 數據全、種類豐富，提供一整套的接口來獲得 ERC721 和 ERC1155 資產以及交易、項目、市場統計等信息，現在支持 50 多個針對 EVM 兼容鏈的公共接口，以及針對 Solana、Aptos、Bitcoin 的一批相同模型的接口，很大程度上滿足了开發者索引多種類型的 NFT 數據的需求。

檢索 NFT Collection 資產相關 API

Retrieve Collections：檢索 NFT Collection 系列

Get an NFT collection（根據 Collection 的合約地址查詢詳情，包括概覽及按照描述對 Item 進行分類，持有者分布、平均價格、地板價等基本概括信息。
Search NFT collections（此接口通過在請求正文中應用搜索過濾器來返回 Collection 列表的信息，Collection 按部署塊編號升序排序。注意：僅使用 block_number 條件篩選數據時，block_number_start 和 block_number_end 之間的範圍不能超過 10000）
Get NFT collections by account（該接口返回具有給定账戶地址的項目列表信息，Collection 按地板價價從高到低排序）
Get NFT collections by ranking（該接口返回具有給定排序字段的項目列表信息，Collection 按給定的排序字段和給定的排序方向排序）

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 的頂級持有者分布）

1）Get NFT collections by account：

/v2/collections/own/{account_address} 通過該接口，我們這裏請求的是账戶地址：0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813 所有 NFT Collection

點擊 Try it 數據響應結果：

該地址下一共持有 20 個 NFT Collection，按照地板價進行排序，以及對其持有項目基礎信息描述等等，該地址下一共持有：BoredApeYachtClub（地板價 29 ETH）、MutantApeYachtClub（地板價 5.82 ETH）、BoredApeKennelClub（地板價 1.968 ETH）、Otherdeed（地板價 0.6194 ETH）、HV-MTL（地板價 0.532 ETH）等等，可見該巨鯨是猴子系列持倉大戶。

2）Collection Statistics：

/v2/statistics/collection/{contract_address} 接口返回了一個 NFT Collection 全方位的統計數據及數據概覽等多維度指標，通過該 API 可以從宏觀層面全面了解一個集合的歷史數據和整體發展狀況，以進行深入的數據分析和模型建立，數據返回：

項目地址："0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

項目名稱："BoredApeYachtClub"

協議標准："erc721"

items 總量：10000/持有者總數:5563

24h：最低價 0.0069e/平均價 28.2441e/交易額 1864.1129e/售出 66

歷史交易總次數：43120

歷史最高價：1080.69 eth

歷史總交易額：1570264.1154 eth

市值：253847 eth

當前地板價：29 eth

交易額：1864.1129e（1d）/6969.425e（7d）/37905.4857e（30d）等等。

3）Collection Trade Distribution：

/v2/statistics/collection/trade/{contract_address} 主要返回一個 NFT Collection 在不同時間段的交易分布數據，具體可參考 NFTScan Traded Distribution：

4）Collection Top Holder：

/v2/statistics/collection/holder/{contract_address} 接口返回指定集合中持有者按照持有量排序，以及持有的該集合中的 NFT 數量和持有時間的分布描述，能夠幫助分析集合的持有者分布情況，判斷市場集中度，是進行集合級別研究的重要數據來源，可以參考 NFTScan Holders：

構建相關 NFT 請求

構建 NFTScan 相關 NFT 數據請求非常簡單方便，开發者只需要在詳盡的 API 文檔中找到所需的接口，根據接口說明配置必要的請求參數，使用代碼或 Postman 等工具按文檔示例快速發起請求，就可以獲取豐富的 NFT 數據，無需處理繁瑣的鏈上提取和數據整合。

例如這裏我們請求 BAYC：

0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 該項目下的 Collection Top Holder 的分布數據詳情，以下是一個示例 Python 代碼：

在這個示例中，我們使用 Python 的 requests 庫來發送 GET 請求，獲取 NFT Collection 的 Top Holder 分布數據詳情，請確保已經安裝了 requests 庫，來根據需要進一步處理響應數據，例如提取和分析持有者的信息以及 NFT 的分布情況。NFTScan 為开發者統一封裝鏈上數據，提供完整的響應格式說明，开發者無需關注底層實現細節，大大降低了獲取 NFT 數據的門檻，使構建 NFT 應用變得簡單高效。

About NFTScan

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

歡迎關注 NFTScan 官方推特獲取最新動態，有關 NFT 數據服務等商務合作請聯系 Telegram: Shier1992