如何使用 NFTScan API 檢索 NFT 合約地址下 Transactions 數據

2024-01-25 18:01:34

對於大多數人而言，獲取某 NFT 合約地址下的全量交易記錄是十分有挑战性的，不僅涉及到對區塊鏈技術的深入了解以及使用相應的工具和資源，還需要處理區塊鏈上的智能合約和交易數據，並將其與外部數據源進行整合分析。通常，區塊鏈上的交易數據分散存儲在區塊中，而且區塊鏈的去中心化性質增加了獲取全量交易記錄的難度，查詢檢索這些記錄更需要處理大量的數據，工作量十分巨大。

但相較於傳統市場，鏈上數據更透明可追溯，也更直觀地反映了 NFT 資產的流動性和持有者體量。了解分析關鍵 NFT 項目的鏈上交易數據，有助及早發現價值窪地。不僅如此，這些交易數據還為各類 Dapp 提供了豐富的堆砌材料，如：

1) NFT 數據分析平臺；2) 加密錢包；3) NFT 資產管理工具；4) NFT 交易市場

5）DID Protocol；6) NFT 鏈上追蹤器；7) NFT 社交平臺；等等。

NFT API 的獲取

對許多开發者來說，自主檢索和獲取 NFT 合約的交易記錄面臨種種困難，例如需要自行搭建節點解析數據，克服數據不統一、實時性差等問題，同時需要投入大量時間去清洗、格式化和分析生硬的數據，而區塊鏈節點的搭建門檻以及解析代碼的开發成本也非常高。

且由於市面上大部分 NFT 項目並沒有都嚴格遵守標准底層智能合約代碼，各項目本身對元數據的存儲方式也各有不同，存儲方式的不標准使得因此單一的查詢產品並不能兼容所有的 NFT 產品，而 NFTScan 將這些難以全部解析的數據進行標准化處理，清晰的將數據呈現到用戶面前。

面對不標准的元數據存儲，NFTScan 實現了標准化處理，避免了解析的障礙，無需自搭建節點。
標准化解析降低了查詢產品开發的門檻，使其可以適用於獲取不同類型 NFT 項目數據。
用戶能獲取到清晰統一的數據，大大提高了使用體驗。

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

怎樣訪問 NFTScan NFT API

在开始使用 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 Transactions 數據

完整的 Transactions 數據可以展示該項目的資金流轉路徑、用戶參與頻率以及活躍地址。通過分析不同時間段的數據，我們可以比較活躍高峯期，判斷市場熱度趨勢；計算資金流動速率，反映項目的粘性與誘引力。當然，關鍵持倉地址也可以被識別出來，用於判斷市場結構和信心度。可以說，合約地址的交易記錄如實反映了用戶的參與熱情，是了解項目真實運行的直接來源。

NFTScan 數據顯示，截至 1 月 25 日主流區塊鏈網絡上已累計發行 NFT 資產 1,481,930,303 枚；NFT Collection 3,401,197 個；產生交易記錄 7,192,237,129 條；總交易額 $97,164,850,168；市值達 $23,893,340,489。

在如此龐大的數字下怎樣找到我們想要檢索的合約地址下的交易記錄呢？通過 NFTScan NFT API 的接口之一“Get transactions by contract”可以直接快速獲取，該接口可以返回某個 NFT 合約下所有的 NFT 交易列表。

在 CHAIN 處可選擇合約部署的網絡，路徑參數包括“contract_address“合約地址，查詢參數可選擇交易的 NFT 事件類型（Mint/Transfer/Sale/Burn），多選則使用 ';' 分隔多個事件，這裏我們以 BoredApeYachtClub 為例，檢索該 NFT Collection 下所有的 Items Sale 相關事件的關鍵數據，輸入自己的 api-key 之後，點擊 Try it，數據結果顯示按照時間戳降序排列：

1）Sale

Sale 數據響應結果共 50783 個 data，每個數據下返回 25 個 items，按照時間戳最近的一條數據信息返回如下：

{

"hash":"0x01fff33621e8839e54736e175c31622ede3ddee3852dcf096be4703bbd1eb96d"

"from":"0xed6af25e6158a2a6106f72126a4db188f55ab723"

"to":"0x29469395eaf6f95920e59f858042f0e28d98a20b"

"block_number":19073463

"block_hash":"0xae824b7bc1531d9778ed5b55bc050a92323541e8ceac446b5b0079c2ca101b20"

"gas_price":"0x2359e0376"

"gas_used":"0x51e0b"

"gas_fee":0.003182497273739794

"timestamp":1706062583000

"contract_address":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

"contract_name":"BoredApeYachtClub"

"contract_token_id":"0x00000000000000000000000000000000000000000000000000000000000016f6"

"token_id":"5878"

"erc_type":"erc721"

"send":"0xcb415344cd0fc552ce7b48ee9375991ff5865895"

"receive":"0x29469395eaf6f95920e59f858042f0e28d98a20b"

"amount":"1"

"trade_value":"0x76b344f2a78c0000"

"trade_price":27

"trade_symbol":"ETH"

"trade_symbol_address":NULL

"event_type":"Sale"

"exchange_name":"Blur"

"aggregate_exchange_name":NULL

"nftscan_tx_id":"1907346301130001"

}

該交易涉及 BAYC 系列 Token id 為 5878 的 Sale 事件，成交價格是 27 ETH，發生於 Blur 交易市場。綜合各字段，我們可以清晰地解析出該筆 NFT 交易的關鍵信息和屬性，如交易哈希值、From 和 To 地址、區塊信息、消耗 Gas、交易時間戳等基礎數據等 NFT 交易的特徵信息。

除此之外，該合約地址下總共發生了 263422 次交互記錄，交互較為頻繁。

其中 Mint 事件 10000 次，即有 10000 個 BAYC items 被初始鑄造發行出來。
Transfer 事件 202637 次，即這些 NFT 在地址間轉移的總次數。
Sales 事件 50783 次，即 NFT 成交交易次數總量。
僅有 2 次 Burn 事件

面對 NFT 市場的不斷變化，實時更新的數據對於跟蹤合約地址下 NFT 活動的動態至關重要。但無需擔心，NFTScan 提供的數據是實時更新的，確保开發者獲取的是最新的和准確的信息。

About NFTScan

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