如何使用NFTScan BTC API 快速創建NFT 應用程序？

Bitcoin NFT 又稱Bitcoin Ordinals 協議，是一種在BTC 區塊鏈上創建數字資產的方法。 2023 年1 月，由軟件工程師Casey Rodarmor 在BTC 比特幣區塊鏈上構建的Ordinals NFT 協議正式發布，允許用戶在比特幣最小單位Satoshi（SAT）上創建獨一無二的NFT，旨在為每satoshis（sat ）分配唯一身份。

通過使用Ord 軟件，該協議將數據添加到這些sats，並允許軟件用戶基於一個序數（ordinal numbers）系統來跟踪它們。換句話說，Ordinal 協議將比特幣最小單位sats 以NFT 的形式表現出來，並為sats 賦予了理由充分的交易價值和收藏價值。自從Ordinals 協議誕生後，用戶就可以在比特幣鏈上銘刻信息，包括文字/ 圖片/ 音頻/ 視頻，從而創造出了BTC 鏈上的NFT。

從Ordinals 發布以來，越來越多的人開始鑄造Bitcoin NFT，就目前發展還處於早期的階段，生態系統尚未完善，但其熱度不減及數量增長十分迅速。根據Bitcoin NFTScan 的數據顯示，截止到7 月27 號，比特幣網絡上已經累計銘刻了1979 萬枚NFT 資產，有60.5 萬個比特幣錢包地址持有NFT 資產，NFTScan 目前已經解析收錄了1534 個Bitcoin網絡上的NFT Collection。開發者可以基於NFTScan 的Bitcoin NFT API 快速創建相關應用程序，例如開發一個NFT Marketplace 等等。

Bitcoin NFTScan： https://btc.nftscan.com/

怎樣訪問NFTScan NFT API

1/ 創建NFTScan 開發者賬號

在開始使用NFTScan API 之前，首先需要訪問開發者網站並創建一個賬戶。前往NFTScan 官方網站（ https://developer.nftscan.com/user/signup ）點擊NFTScan API “Sign Up”按鈕進行註冊。

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

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

查看BitcoinAPI 文檔

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

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

Bitcoin API 主要包括了以下三個模型：Asset Model/Transaction Model/Collection Model，包括裡面一些核心的字段的整體介紹和說明，方便開發者知道怎麼去利用這些信息服務於自己正在構建的Dapp 服務。

Assets API： Assets 是NFT 最關鍵的數據字段，可用於標識並描述該數字資產。開發者可以提取BTC 區塊鏈上NFT 的關鍵數據，從而建立起全面認知，並構建相關應用。 Assets 對象提供了數字資產的唯一標識以及全生命週期的數據，是開發者理解和應用NFT 的基礎。

NFTScan BTC API 中的核心數據模型即為Assets，它代表了每一個獨特的數字項目，主要包括了銘文id、銘文編號、collection 名稱、tx_hash、區塊number、mint 價格、持有者等全面數據。

Transactions API：交易模型代表了區塊鏈上一個NFT 資產的全量交易數據，為開發者提供了NFT 的全生命週期交易數據。 NFTScan 不斷收錄各個區塊鍊網絡上的NFT 交易市場及其交易合約信息，通過分析和解讀合約源代碼和交易日誌，並將其納入其數據解析邏輯中。根據NFTScan 數據，截至7 月底，主流15 條鏈上NFT 鏈上記錄數量共2,126,014,489 條，目前已收錄了主流14 條鏈上的150 個交易市場全面信息，持續收錄其交易數據。

用戶可以通過Transactions API 獲取任意NFT 資產完整的交易記錄、行為日誌及當前所有權信息，實現對NFT 的全面跟踪，為開發者分析NFT 的交易特徵、價格走勢、流轉路徑等提供了全面可靠的數據來源。

Collections API： NFTScan 獲取與NFT Collections 相關的描述、社交媒體及其他基本信息等都鏈下數據。 NFTScan 通過各個區塊鍊網絡中最主流的NFT 市場提供的API 獲取這些信息。此外當前地板價信息是基於NFT 市場的訂單信息的集中式數據，也是通過API 可獲取的。

NFTScan 會持續跟踪新出現的NFT 項目，并快速獲取其在各交易平台公開的鏈下數據信息，通過Collections API 開放給開發者，這使得開發者可以無需逐個聚合不同平台的數據，就可以通過Collections API 獲取項目的鏈下描述、持有者、交易活動等關鍵信息，並集成到應用中。

查詢相關API

Get NFTs by collection：通過NFTScan BTC APIRetrieve Assets的接口之一“/btc/assets/collection/{collection}”開發者可以通過檢索NFTCollection的名稱，該接口返回一組屬於NFT合約地址的NFTs，並且按inscription_id升序排序。

輸入檢索NFT Collection 的名稱，點擊Try it將返回該集合下的所有NFT 資產的詳細信息返回數據等等，數據默認分頁返回，可通過limit 和cursor 參數控制每頁數量和頁碼。獲取到所有NFT 數據後，可以用於展示、分析或其他應用場景。使用這個API 可以方便地批量獲取某個NFT 項目中的所有NFT 數據，為打造NFT 應用提供強大支持。數據顯示如下：

Get cursed inscriptions：該接口返回一組被詛咒的銘文NFT，NFT 按inscription_number 升序排序。比特幣NFT 協議Ordinals 已經升級到了v0.6.0 版本，該版本中最引人注目的更新當屬對「詛咒銘文」的支持，一些被成功刻錄的銘文沒有被索引器分配序號而無法被檢索，即被稱為「詛咒銘文」。 NFTScan 同樣對其數據進行整合收錄，方便開發者們使用。

Get transactions by inscription ID ：該接口主要通過檢索BTC NFT 的銘文ID（inscription ID），接口路徑為：“/btc/transactions/{inscription_id}”，開發者可以方便獲取某個NFT 從Mint 到所有流轉的全生命週期交易數據，開發者以實現對NFT 歷史的追溯分析。

查詢參數字段可供選擇包括event_type（交易事件類型）：Mint/Transfer 使用';'用來分隔多個事件。

構建相關API 請求

一旦在NFTScan 的API 文檔中找到所需的BTC API 接口和參數後，開發者可以使用選擇的編程語言編寫API 請求代碼。訪問NFTScan 的API 文檔，會提供以下信息：

• API 端點（Endpoint）：API 請求的URL 地址，通常以HTTP 或HTTPS 開頭。

• 支持的請求方法（HTTP Methods）：常見的請求方法有GET、POST、PUT、DELETE 等，用於指定對API 的操作類型。

• 請求參數（Request Parameters）：API 請求可能需要傳遞一些參數，這些參數可以是URL 參數、請求體中的數據等，用於指定請求的具體內容。

• 響應數據（Response Data）：API請求成功後，服務器會返回相應的數據，通常以JSON或XML格式進行返回。

開發者在選擇使用的編程語言中，可以使用HTTP 庫或API 客戶端庫來發起HTTP 請求，並將所需的參數和頭部信息包含在請求中。例如，使用Python 可以使用requests 庫，而使用JavaScript 可以使用axios 或fetch 等庫。

編寫API 請求代碼的一般流程如下：

1. 引入所需的HTTP 庫或API 客戶端庫。

2. 構建API 請求的URL，包含端點和參數（如果有）。

3. 設置請求方法、請求頭（如果需要認證）以及請求體（如果是POST 或PUT 請求）。

4. 發起API 請求並接收服務器的響應。

5. 解析響應數據並進行相應處理。

記得在編寫API 請求代碼時，查閱NFTScan 的API 文檔，確保正確使用API 端點、參數和認證方式以便成功與NFTScan 進行交互獲取所需的數據。

例如，構建一個請求獲取Bitcoin Frogs NFT 數據的API 請求，查找NFTScan BTC API 的文檔或參考文檔後，這裡使用接口

Get NFTs by collection： “/btc/assets/collection/{collection}”

使用HTTP GET 請求訪問NFTScan 的API 端點，並傳遞所需的參數。例如，使用Python 的requests 庫，可以這樣構建請求：

在上述代碼中，我們首先構建了完整的API 請求URL，然後使用requests.get() 方法發送GET 請求，並從響應中獲取返回的NFT 數據（假設NFT 數據是以JSON 格式返回的）。最後開發者可以根據需求對獲取到的NFT 數據進行進一步處理和分析。

不僅是Bitcoin NFT API，開發者可以根據自己的應用構建需求，靈活調取NFTScan 提供的豐富NFT 數據資源。 NFTScan 的NFT API 為開發者提供了全面、實時、可靠的NFT 核心數據，使開發者能夠快速獲取所需的NFT 數據，大大簡化和加速開發過程。開發者可以按照自己的業務場景自由組合這些API，構建符合自己需求的NFT 應用程序或解決方案。 NFTScan 持續優化API，推出更多高級功能，以進一步提升開發者的工作效率，降低開發成本。為開發者提供了專業可靠的NFT 基礎數據支撐，使開發者能更加專注於應用程序的創新。