如何获取Solana NFT：资产、集合和证明

概述

本指南涵盖使用Helius数字资产标准（DAS）API读取NFT和数字藏品：获取单个资产、列出钱包的NFT、按集合或创建者查询、处理压缩NFT和Merkle证明、列出版本以及读取交易历史。有关可替代代币——余额、供应、持有者和价格的内容，请参见获取SPL代币指南。相同的getAsset和getAssetsByOwner方法服务于NFT和代币；此页面侧重于NFT和收藏品的工作流程。

何时使用

当您需要以下操作时，请使用此页面上的方法：

显示单个NFT的元数据、图像和属性
列出一个钱包拥有的每一个NFT用于投资组合或画廊
使用集合和创建者查询为市场或浏览器提供支持
验证或转移压缩NFT（需要Merkle证明）
显示NFT的链上交易历史
列出从主NFT印刷的版本

NFT方法

首先使用getAsset获取单个NFT或使用getAssetsByOwner获取钱包的集合。每个卡片链接到完整的API参考。

getAsset

通过ID获取一个NFT的完整数据。

getAssetsByOwner

列出一个钱包持有的所有NFT。

searchAssets

按集合、创建者、属性等进行筛选——详见搜索资产指南。

getAssetsByCreator

获取创建者铸造的所有资产。

getAssetsByGroup

获取集合中的所有资产。

getSignaturesForAsset

获取资产的交易历史。

getNftEditions

获取从主NFT印刷的版本。

getAssetProof

获取压缩NFT的Merkle证明。

获取单个NFT

通过其ID检索一个NFT的完整元数据、所有权和集合数据：

const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAsset',
    params: { id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk' },
  }),
});

const { result } = await response.json();
console.log(result.content.metadata.name, result.ownership.owner);

更多NFT查询

列出钱包的NFT — getAssetsByOwner

const getNFTsByOwner = async (ownerAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByOwner',
      params: { ownerAddress, page: 1, limit: 10 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTsByOwner('86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY');

按创建者 — getAssetsByCreator

const getAssetsByCreator = async (creatorAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByCreator',
      params: { creatorAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCreator('9uBX3ASjxWvNBAD1xjbVaKA74mWGZys3RGSF7DdeDD3F');

按合集 — getAssetsByGroup

const getAssetsByCollection = async (collectionAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByGroup',
      params: { groupKey: 'collection', groupValue: collectionAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCollection('J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w');

交易历史 — getSignaturesForAsset

const getNFTTransactionHistory = async (mintAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getSignaturesForAsset',
      params: { id: mintAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTTransactionHistory('FNt6A9Mfnqbwc1tY7uwAguKQ1JcpBrxmhczDgbdJy5AC');

压缩NFT

状态压缩NFT（cNFTs）使用与常规NFT相同的方法读取 — getAsset、getAssetsByOwner和searchAssets都返回它们。压缩特有的两点是：

Merkle证明 — 链上操作如转移和销毁需要来自getAssetProof的证明。
历史 — 使用getSignaturesForAsset（如上所示）获取cNFT的交易历史。

获取Merkle证明 — getAssetProof

const getProof = async (id) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetProof',
      params: { id },
    }),
  });

  const { result } = await response.json();
  return result; // { root, proof, node_index, leaf, tree_id }
};

getProof('Bu1DEKeawy7txbnCEJE4BU3BKLXaNAKCYcHR4XhndGss');

最佳实践

对于返回大量结果集的方法，使用分页。
使用try/catch处理错误，并使用指数退避重试瞬时故障。
在适当情况下缓存响应以减少API调用。
当有多个ID时，使用getAssetBatch代替多个单独的getAsset调用。

下一步

获取SPL代币

可替代代币余额、供应、持有者和价格。

搜索资产

按合集、创建者和属性过滤NFT。

DAS API 常见问题

关于资产、价格数据和使用的常见问题。

入门

数据流和事件监听

数据 API 和 RPC

交易

发送交易

钱包即服务

指南

资源

如何获取Solana NFT：资产、集合和证明

概述

何时使用

NFT方法

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

获取单个NFT

更多NFT查询

压缩NFT

最佳实践

下一步

获取SPL代币

搜索资产

DAS API 常见问题

​概述

​何时使用

​NFT方法

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​获取单个NFT

​更多NFT查询

​压缩NFT

​最佳实践

​下一步

获取SPL代币

搜索资产

DAS API 常见问题

概述

何时使用

NFT方法

获取单个NFT

更多NFT查询

压缩NFT

最佳实践

下一步