近年來隨著區塊鏈的快速發展,面對大量NFT 資產數據,開發者正處在檢索困境,存在公鏈上的NFT 資產數據呈爆炸式增長。 NFT 的數量和種類非常多,而且分散在不同的區塊鏈上,所以需要花費大量的時間和精力來解析和清洗數據。這給NFT 應用開發者帶來了一個極大挑戰——如何高效檢索NFT 數據?
數據顯示截止2023 年8 月11 日,NFTScan 目前支持的16 條主流區塊鍊網絡共產生:NFT 合約數量2,645,817;NFT 資產數量989,645,900;NFT 鏈上記錄數量1,953,053,655;NFT 持倉錢包地址數量135,133,478;NFT 資產總市值$12,783,263,824;NFT 歷史總交易額$65,083,327,113。
目前為止,開發者在獲取和利用NFT 數據方面正面臨許多困難。首先NFT 數據分佈在眾多公有鏈上,鏈與鏈之間處於分割狀態,無法實現數據互通,開發者很難聚合不同鏈上的NFT 數據,實現統一訪問。其次,即便在同一條公鏈上,也存在海量不同類別的NFT 項目,要逐個檢索NFT 元數據及交易等信息,工作量巨大。
當前開發者難以找到便捷的工具來手動獲取NFT 數據,可以看到許多正處在構建開發者NFT 工具之上的優秀團隊正朝這個方向前進,例如NFTScan 等數據基礎設施服務商。這些NFT 相關的數據平台提供了一種簡單而有效的解決方案,即NFT API。通過NFT API 接口,開發者可以輕鬆地訪問鏈上的NFT 數據,並對其進行分析、處理、統計和可視化。
怎樣訪問NFTScan NFT API
1/ 創建NFTScan 開發者賬號
在開始使用NFTScan API 之前,首先需要訪問開發者網站並創建一個賬戶。前往NFTScan 官方網站點擊NFTScan API “Sign Up”按鈕進行註冊。
https://developer.nftscan.com/user/signup
登錄後在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、Avalanche、Arbitrum、Optimism、Fantom、Moonbeam、PlatON、Cronos、Gnosis16條區塊鏈的NFT 全量數據,所涵蓋的NFT 數據全、種類豐富,提供一整套的接口來獲得ERC721 和ERC1155 資產以及交易、項目、市場統計等信息,現在支持50 多個針對EVM 兼容鏈的公共接口,以及針對Solana、Aptos、Bitcoin 的一批相同模型的接口,很大程度上滿足了開發者索引多種類型的NFT數據的需求。
檢索NFT 資產相關API
Get NFTs by account (通過賬戶地址檢索NFT)
Get all NFTs by account (檢索賬戶地址的所有NFT,並根據合約地址對NFT 進行分組,如果賬戶地址擁有的NFT 總數超過2000 個,則返回的NFT 將限制在2000 個以下。在這種情況下,開發者和用戶可以通過分頁查詢請求按賬戶獲取該賬戶地址擁有的所有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 (該接口通過在請求正文中應用搜索篩選器來返回NFT 資產列表。資產按nftscan_id 升序排序。注意:僅使用block_number 條件過濾數據時,block_number_start 和block_number_end 之間的範圍不能超過10000)
Get NFTs by attributes (該接口返回一組屬於具有屬性的NFT 合約地址的NFT。NFT 按token_id 升序排序)
Get all multi-chain NFTs by account (該接口返回賬戶地址擁有的所有多鏈NFT,NFT 根據合約地址進行分組)
這些API 極大簡化開發者獲取跨鏈NFT 數據的複雜度,一站式提供所有鏈數據,可廣泛應用於數據查詢、可視化展示、數據分析等場景,並且建立在可靠API 之上可以大幅提升開發效率。
1)Get all NFTs by account: “/v2/account/own/all/{account_address}”通過該接口,我們這裡請求的是巨鯨地址:
0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813 的所有NFT。
點擊Try it 數據響應結果:該地址下一共有349 個item,分別按照100 的區間進行分組,例如,我們對對其持有一些頂級NFT Collection 的基礎信息描述等等,可見該地址是BAYC 系列持倉大戶:
1)Collection地址為
0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
名稱為BoredApeYachClub,該項目items_total 共有10000 個, owns_total 該地址下共持有26 個,symbol 為BAYC,地板價為30 ETH。
2) Collection 地址為
0x60e4d786628fea6478f785a6d7e704777c86a7c6
名稱為MutantApeYachtClub,該項目items_total 共有19481 個,owns_total 該地址下共持有23個,symbol 為MAYC,地板價為5.7399ETH。
3)Collection地址為
0xba30e5f9bb24caa003e9f2f0497ad287fdf95623
名稱為BoredApeKennelClub,該項目items_total 共有9602個,owns_total 該地址下共持有23個,symbol 為BAKC,地板價為2.1878ETH。
2)Get all multi-chain NFTs by account:
“/v2/assets/chain/{account_address}”該接口可以用來獲取一個錢包地址跨鏈上的全部NFT 資產,聚合了用戶分散的跨鏈NFT,有助於全局化分析用戶行為,也為跨鏈應用提供了數據基礎。主要有以下使用場景:
實現跨鏈的NFT 資產展示和管理,可以通過這個接口全部的鏈上資產集中展示。
分析用戶跨鏈的NFT 持有偏好和投資組合,了解用戶的全局NFT 資產分佈。
統計用戶跨鏈NFT 總量,評估用戶的綜合影響力。
監控用戶跨鏈NFT 資產變動,發現異常賬戶或交易行為。
支持跨鏈NFT 交易,查詢用戶跨鏈資產。
這裡我們同樣檢索的是巨鯨地址:
0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813點擊Try it 數據響應結果顯示該地址在Ethereum 和BNBchain上活躍,可以看到在eth網絡上一共有349 個Collections,bnb 網絡上有2 個Collections,包括對其持有的item 精確的數據分析。
3)Get NFTs by contract: “/v2/assets/{contract_address}”該接口主要用於根據指定的合約地址,獲取該合約下面生成的所有NFT 資產的列表,典型使用場景:
獲取某個NFT 項目中的所有NFT,只需要根據該項目的合約地址篩選,就可以返回該項目生成的所有NFT ID 列表。
按合約地址批量獲取NFT 元數據,通過合約地址可以先拿到所有的tokenId,再批量獲取每個tokenId 的元數據。
構建NFT 項目的產量分析,通過獲取項目不同時間段部署的所有NFT 數量,可以分析項目的成長情況。
跟踪某個合約地址中的NFT 流轉情況,通過定時獲取合約中的NFT 列表,檢測NFT 的轉入和轉出。
數據響應結果顯示該NFTCollection所以item的基礎數據及元數據信息,這裡我們選擇了BoredApeYachClub,返回數據按照token_id 進行排序,例如id 為0 的item:
1)單個item 基礎數據:
0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 及名稱為Bored Ape Yacht Club,這裡查詢的NFT Token id 為0,在項目中的佔比為1,協議標準為erc721,Mint 時的錢包地址/持有者錢包地址,被鑄造時的時間戳/Mint 的哈希地址/Token URI 的地址。
latest_trade_price(上次成交價)/latest_trade_symbol(上次成交價的貨幣),latest_trade_timestamp(上次成交時間戳)當前顯示null,返還數值空,表示該項目未進行過交易。
2)元數據:從該項目的元數據可以看出Metadata 數據託管在ipfs 上,格式為image/png,存儲路徑為:
ipfs://QmcJYkCKK7QPmYWjp4FD2e3Lv5WCGFuHNUByvGKBaytif4以及為對該圖片的細節特徵描述。
3)稀有度:得分為1.08649973006184,綜合稀有度排名為2273 名。
NFTScan 不僅專注於提供檢索NFT 資產的API,更向開發者開放了多維度、全方位的NFT 數據資源,數據資源覆蓋從NFT 元數據、用戶數據到行業數據等多個層面。豐富的數據資源類型為開發者提供了高度定制化的組合選擇,開發者可以根據自己應用的實際業務需求,從接口中自由調取適合的NFT 數據。
可以說,NFTScan 提供了異於傳統區塊鏈數據平台的定制化NFT 數據調取體驗。這不僅豐富了應用的功能設置,也大幅降低了開發者獲取和處理NFT 數據的成本。隨著接口的持續擴充與優化,NFTScan 將成為開發者的NFT 數據服務backbone。我們期待開發者可以在這裡自由發揮創意,孕育出更多NFT 創新應用,推進整個行業的發展。