Como Obter NFTs Solana: Ativos, Coleções e Provas

Visão Geral

Este guia abrange a leitura de NFTs e colecionáveis digitais com a Helius Digital Asset Standard (DAS) API: buscar um único ativo, listar NFTs de uma carteira, consultar por coleção ou criador, trabalhar com NFTs comprimidos e provas de Merkle, listar edições e ler o histórico de transações. Para tokens fungíveis — saldos, suprimento, detentores e preços — veja o Guia de Obtenção de Tokens SPL. Os mesmos métodos getAsset e getAssetsByOwner servem tanto para NFTs quanto para tokens; esta página se concentra nos fluxos de trabalho de NFTs e colecionáveis.

Quando usar isto

Use os métodos nesta página quando você estiver:

Exibindo os metadados, imagem e atributos de um único NFT
Listando todos os NFTs que uma carteira possui para um portfólio ou galeria
Fornecendo um marketplace ou explorador com consultas de coleção e criador
Verificando ou transferindo NFTs comprimidos (que requerem provas de Merkle)
Mostrando o histórico de transações on-chain de um NFT
Listando as edições impressas a partir de um NFT mestre

Métodos de NFT

Comece com getAsset para um único NFT ou getAssetsByOwner para a coleção de uma carteira. Cada cartão se liga à sua referência completa da API.

getAsset

Dados completos de um NFT por seu ID.

getAssetsByOwner

Todos os NFTs mantidos por uma carteira.

searchAssets

Filtrar por coleção, criador, atributos e mais — veja o Guia de Busca de Ativos.

getAssetsByCreator

Todos os ativos cunhados por um criador.

getAssetsByGroup

Todos os ativos em uma coleção.

getSignaturesForAsset

Histórico de transações para um ativo.

getNftEditions

Edições impressas de um NFT mestre.

getAssetProof

Prova de Merkle para um NFT comprimido.

Buscar um único NFT

Recupere metadados completos, dados de propriedade e coleção para um NFT por seu 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: 'getAsset',
    params: { id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk' },
  }),
});

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

Mais consultas de NFT

Listar NFTs de uma carteira — 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');

Por criador — 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');

Por coleção — 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');

Histórico de transações — 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');

NFTs Comprimidos

NFTs comprimidos por estado (cNFTs) são lidos com os mesmos métodos que NFTs regulares — getAsset, getAssetsByOwner, e searchAssets os retornam. Duas coisas são específicas para a compressão:

Provas de Merkle — operações on-chain, como transferências e queimas, requerem uma prova de getAssetProof.
Histórico — use getSignaturesForAsset (mostrado acima) para o histórico de transações de um cNFT.

Obter uma prova de 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');

Melhores práticas

Use paginaçao para métodos que retornam conjuntos de resultados grandes.
Lide com erros usando try/catch e replique falhas transitórias com backoff exponencial.
Cacheie respostas quando apropriado para reduzir chamadas à API.
Use getAssetBatch em vez de muitas chamadas individuais de getAsset quando você tiver múltiplos IDs.

Próximas etapas

Obter Tokens SPL

Saldos de tokens fungíveis, suprimento, detentores e preços.

Buscar Ativos

Filtrar NFTs por coleção, criador e atributos.

FAQs da DAS API

Perguntas comuns sobre ativos, dados de preço e uso.

Primeiros Passos

Transmissão de Dados & Escuta de Eventos

APIs de Dados & RPCs

Negociação

Envio de Transações

Carteira como Serviço

Guias

Recursos

Como Obter NFTs Solana: Ativos, Coleções e Provas

Visão Geral

Quando usar isto

Métodos de NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

Buscar um único NFT

Mais consultas de NFT

NFTs Comprimidos

Melhores práticas

Próximas etapas

Obter Tokens SPL

Buscar Ativos

FAQs da DAS API

​Visão Geral

​Quando usar isto

​Métodos de NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​Buscar um único NFT

​Mais consultas de NFT

​NFTs Comprimidos

​Melhores práticas

​Próximas etapas

Obter Tokens SPL

Buscar Ativos

FAQs da DAS API

Visão Geral

Quando usar isto

Métodos de NFT

Buscar um único NFT

Mais consultas de NFT

NFTs Comprimidos

Melhores práticas

Próximas etapas