如何使用 NFTScan 的 TON API 實現 NFT 應用開發？

作者：NFT_Research

上周 NFTScan 開發者平臺已上線了 TON 網路的 NFT API 服務，TON（The Open Network）是由 Telegram 團隊打造的一條 Layer 1 高性能公鏈，採用自己的 TVM 虛擬機，與 EVM 不相容。 通過先進的技術架構實現每秒百萬級 TPS 的高速處理，並支援智慧合約和 DApp 開發。 TON 採用了分片機制提升擴展性，同時通過數據分片等方式保證網路安全，旨在建立一個高速、安全、可擴展的去中心化網路，為構建Web 3.0生態打下堅實基礎。

目前 TON 網路上已累計發行 NFT 資產 1,204,487 枚，NFT Collection 10,123 個，產生交易記錄 2,888,936 條，有過交互的錢包位址 762,453 個，總交易額 15,083,265 TON。 目前除了相容 EVM 的 15 條鏈， NFTScan 還支援了另外 4 條是非 EVM 區塊鏈：Bitcoin、Aptos、Solana。

您的 NFT 可以：

![CD877647ed9d94de3a90fd8c1ac232bc.png]（https://img.jinse.cn/7119851_image3.png）

怎樣訪問 NFTScan NFT API以及創建 NFTScan 開發者帳號

在開始使用NFTScan API 之前，首先需要訪問開發者網站並創建一個帳戶。 前往 NFTScan 官方網站點擊 NFTScan API “Sign Up”按鈕進行註冊。

![e716243785661283940c7332ac4dd370.png]（https://img.jinse.cn/7119852_image3.png）

登錄后在 Dashboard（面板）上找到自己獨有的 API KAY，將其複製。 訪問 API 文件，將自己的 API KEY 輸進 API 文件的相應位置。 根據文檔的指引，就可以開始使用 API 服務了。 在 API 文件中，開發者可以找到多種可供選擇的介面模式，根據需求來選擇最合適的介面。

![2a36dbcb7aa6c9b008a345724ab09686.png]（https://img.jinse.cn/7119853_image3.png）

在 Dashboard 中，開發人員還可以查看自己 API 使用方式的統計數據，幫助記錄歷史使用數據。 不僅如此，NFTScan 還為每位註冊開發者提供 1M CU 的 API 調用服務，用於請求所有的 NFT API 介面，並且 CU 永不過期，用完為止！

查看 TON 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 資料的需求。

![6e5ffe734d8eba168262ad2ad915bee0.png]（https://img.jinse.cn/7119854_image3.png）

TON API 主要包括了以下五個類型介面：

Retrieve Asset/Retrieve Transaction/Retrieve Collection/Statistics/Refresh Metadata，包括裡面一些 API 核心的字段的整體介紹和說明，方便開發者知道怎麼去獲取數據利用這些資訊服務於自己正在構建的 Dapp 服務。

Retrieve Asset 系列：

1. 按帳戶獲取 NFT：/噸/帳戶/擁有/{帳戶_address}
2. 按帳戶獲取所有 NFT：/噸/帳戶/擁有/全部/{帳戶_address}
3. 通過帳戶獲取鑄造的 NFT：/sol/account/mint/{account_address}
4. 通過合約獲取 NFT：/噸/資產/收藏/{合約}
5. 獲得單個 NFT：/噸/資產/{代幣_address}
6. 獲取多個 NFT：/噸/資產/批次

這個類型的 API 為開發者提供了簡單高效的方式去獲取各種 NFT 數據，包括根據使用者帳戶或合約地址獲取相關 NFT 清單，獲取單個或多個 NFT 的詳細資訊等。 開發者可以通過這類介面直接獲取鏈上 NFT 的基礎資訊、元數據等，無需自己提取和處理鏈上原始數據。 這類介面減輕了鏈上數據複雜度，大大降低獲取NFT細節數據的難度，是開發基於TON NFT 的 DApp、數據分析等應用的重要基礎。

Retrieve Transaction 系列：

1. 按賬戶獲取交易：/噸/交易/帳戶/{帳戶_address}
2. 按合約獲取交易：/噸/交易/收集/{合約}
3. 通過 NFT：/ton/transactions/{token_address} 獲取交易

這類型的介面可以方便獲取 TON NFT 在鏈上發生的各種交易資訊，包括根據帳戶、集合、資產位址等獲取該 NFT 的歷史交易記錄，返回每筆交易的關鍵數據。 這類介面提供鏈上原始的區塊事件數據，開發者無需處理鏈上提取，就可以通過簡單的介面調用獲得需要的 TON NFT 交易數據。 獲得這些數據后，開發者可以基於此實現數據分析、交易系統等應用。

Retrieve Collection 系列：

1. 獲取 NFT 收藏：/噸/收藏/{收藏}
2. 搜索 NFT 收藏：/噸/收藏/過濾器

通過指定集合地址或過濾條件搜索 NFT Collection，返回匹配條件的集合清單。 開發者可以利用這些介面獲得任意專案的概況及清單，並基於此開發應用程式，例如數據分析平臺可以統計每個集合的情況，可以展示熱門 NFT Collection 的資訊。

Statistics 系列：

1. 交易排名：/噸/統計/排名/交易
2. 收藏統計：/噸/統計/收藏/{收藏}

Trade Ranking 介面可以獲取 TON 鏈上 NFT 交易排行榜，Collection Statistics 介面可以通過指定專案位址，獲取該集合的關鍵統計數據等。 這些統計類介面可以大幅簡化開發者獲取 NFT 數據來進行統計分析的工作，構建 NFT 交易分析平臺，或者為 NFT 應用提供關鍵的統計參數。

1. 刷新元數據：/噸/刷新/元數據

這個介面用來提交刷新指定 NFT 資產的元數據後台任務。

![b0b628904b41fbfe8064c2c77d6305b5.png]（https://img.jinse.cn/7119855_image3.png）

查詢相關 API

1/ 通過合約獲取 NFT：/噸/資產/合約/{合約_address}

通過 NFTScan TON API 的該介面，開發者可以通過檢索一個 NFT 合約位址，並返回整個 Contract 的一組 NFT 資訊清單，NFT 按代幣位址升序排列。

這裏我們輸入合約位址：EQCA14o1-VWhS2efqoh_9M1b_A9DtKTuoqfmkn83AbJzwnPi

![85dfefc32e76f8ed53d44b3ec34819e4.png]（https://img.jinse.cn/7119856_image3.png）

點擊 Try it 將返回該合約位址下的所有 NFT 資產的詳細資訊返回數據等等，數據預設分頁返回，可通過 limit 和 cursor 參數控制每頁數量和頁碼，返回數據包括每個 NFT 的 token address、token id、metadata、owner 位址等數據。 返回數據預設分頁返回，可通過 limit 和 cursor 參數控制每頁數量和頁碼，靈活獲取不同粒度的 NFT 數據。 獲得返回的數據后，開發者可以構建應用展示 NFT 詳情，或者提取數據進行後續分析處理。

可以看到該合約位址下共有 102185 個 Items，數據顯示如下：

![4183486021b727d46cdc79a5a73f7660.png]（https://img.jinse.cn/7119857_image3.png）

2/ 按賬戶獲取交易：/噸/交易/帳戶/{帳戶_address}

通過調用該介面並輸入帳戶地址，查詢參數可選擇指定NFT 合約地址進行查詢，開發者可以輕鬆獲得該錢包地址作為 sender 或 receiver 參與的所有歷史 NFT 轉帳交易數據，包括每筆交易的區塊高度、時間戳、Token ID、交易價格、交易類型等資訊。 這裡我們查詢的位址為：

EQBwPvcqbRCICLo3cWOiFPO1QdmNZBcYAfpvwEaxjr9hKP-R

![f195bc86beac8b841220180085351AD7.png]（https://img.jinse.cn/7119858_image3.png）

3/ 交易排名： /噸/統計/排名/交易

該介面可以幫助開發者快速獲取 TON 生態中 NFT 專案的 Ranking 排名數據。 該介面會返回按照篩選條件如交易額從高到低排列的一組數據。 通過該排名清單，開發者可以清晰地看到交易最活躍的NFT專案，判斷不同專案的流動性情況，確定潛力專案或需要更多研究的專案。

我們可以查看查詢參數 time：15m/30m/1h/6h/12h/1d/7d/30d; 排序字段：volume/sales/floor_price/average_price 等進行條件篩選的 NFT 交易排名數據統計，可參考 TON NFTScan Trading

![e0a1eaabedea4aa484bab65556bd63fc.png]（https://img.jinse.cn/7119859_image3.png）

構建相關 API 請求

開發者在 NFTScan 的 API 文件中找到所需的 TON API 介面和參數後，可以使用選擇的程式設計語言（如 Python、Java、Java 等）編寫 API 請求代碼。 下面是一些通用的步驟，以及一個示例來說明如何使用 Python 編寫 TON API 請求代碼：

1、首先，導入所選程式語言中的 HTTP 請求庫。 在 Python 中，通常會使用 requests 庫

2、定義 NFTScan API 的基本 URL 和所需的參數。 在 API 文件中找到合適的介面和參數

3、將參數添加到基本 URL 和端點中，構建完整的 API 請求 URL

4、使用所選程式設計語言的 HTTP 庫發起請求，通常是一個 GET 請求

5、檢查 HTTP 回應的狀態碼，通常狀態碼為 200 表示請求成功

![fa04c1eb90eb45842797db0d2d0f2285.png]（https://img.jinse.cn/7119860_image3.png）

這些通用步驟可以用於與 NFTScan API 或其他類似的 API 進行交互，根據 API 文件中提供的資訊來構建和發起請求，以及處理返回的數據。