Comment obtenir des NFTs Solana : actifs, collections et preuves

Vue d’ensemble

Ce guide couvre la lecture de NFTs et de collectibles numériques avec l’API Helius Digital Asset Standard (DAS) : récupération d’un seul actif, liste des NFTs d’un portefeuille, requête par collection ou créateur, travail avec des NFTs compressés et des preuves de Merkle, liste des éditions, et lecture de l’historique des transactions. Pour les tokens fongibles — soldes, offre, détenteurs et prix — voir le guide Obtenir des tokens SPL. Les mêmes méthodes getAsset et getAssetsByOwner servent à la fois les NFTs et les tokens; cette page se concentre sur les workflows des NFTs et des collectibles.

Quand utiliser cela

Utilisez les méthodes de cette page lorsque vous :

Affichez les métadonnées, l’image et les attributs d’un seul NFT
Listez chaque NFT qu’un portefeuille possède pour un portfolio ou une galerie
Alimentez une marketplace ou un explorateur avec des requêtes de collection et de créateur
Vérifiez ou transférez des NFTs compressés (qui nécessitent des preuves de Merkle)
Montrez l’historique des transactions on-chain d’un NFT
Listez les éditions imprimées à partir d’un NFT maître

Méthodes NFT

Commencez avec getAsset pour un seul NFT ou getAssetsByOwner pour la collection d’un portefeuille. Chaque carte est liée à sa référence complète d’API.

getAsset

Données complètes pour un NFT par son ID.

getAssetsByOwner

Tous les NFTs détenus par un portefeuille.

searchAssets

Filtrez par collection, créateur, attributs, et plus encore — voir le guide Rechercher des actifs.

getAssetsByCreator

Tous les actifs mintés par un créateur.

getAssetsByGroup

Tous les actifs d’une collection.

getSignaturesForAsset

Historique des transactions pour un actif.

getNftEditions

Éditions imprimées à partir d’un NFT maître.

getAssetProof

Preuve de Merkle pour un NFT compressé.

Récupérer un seul NFT

Récupérez les métadonnées complètes, la propriété, et les données de collection pour un NFT par son 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);

Plus de requêtes NFT

Lister les NFTs d'un portefeuille — 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');

Par créateur — 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');

Par collection — 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');

Historique des transactions — 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 compressés

Les NFTs compressés (cNFTs) sont lus avec les mêmes méthodes que les NFTs réguliers — getAsset, getAssetsByOwner, et searchAssets les renvoient tous. Deux éléments sont spécifiques à la compression :

Preuves de Merkle — les opérations on-chain telles que les transferts et les destructions nécessitent une preuve de getAssetProof.
Historique — utilisez getSignaturesForAsset (montré ci-dessus) pour l’historique des transactions d’un cNFT.

Obtenir une preuve 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');

Meilleures pratiques

Utilisez la pagination pour les méthodes qui renvoient de grands ensembles de résultats.
Traitez les erreurs avec try/catch et réessayez les échecs transitoires avec un backoff exponentiel.
Mettez en cache les réponses lorsque cela est approprié pour réduire les appels API.
Utilisez getAssetBatch au lieu de nombreuses appels simples getAsset lorsque vous avez plusieurs IDs.

Prochaines étapes

Obtenir des tokens SPL

Soldes, offre, détenteurs, et prix des tokens fongibles.

Rechercher des actifs

Filtrer les NFTs par collection, créateur, et attributs.

FAQ de l'API DAS

Questions courantes sur les actifs, les données de prix et l’utilisation.

Commencer

Diffusion de données et écoute d'événements

API de données et RPC

Trading

Envoyer des transactions

Wallet en tant que service

Confidentialité

Ressources

Comment obtenir des NFTs Solana : actifs, collections et preuves

Vue d’ensemble

Quand utiliser cela

Méthodes NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

Récupérer un seul NFT

Plus de requêtes NFT

NFTs compressés

Meilleures pratiques

Prochaines étapes

Obtenir des tokens SPL

Rechercher des actifs

FAQ de l'API DAS

​Vue d’ensemble

​Quand utiliser cela

​Méthodes NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​Récupérer un seul NFT

​Plus de requêtes NFT

​NFTs compressés

​Meilleures pratiques

​Prochaines étapes

Obtenir des tokens SPL

Rechercher des actifs

FAQ de l'API DAS

Vue d’ensemble

Quand utiliser cela

Méthodes NFT

Récupérer un seul NFT

Plus de requêtes NFT

NFTs compressés

Meilleures pratiques

Prochaines étapes