Solana-NFTs abrufen: Assets, Collections und Proofs

Überblick

Diese Anleitung zeigt dir, wie du NFTs und digitale Sammlerstücke mit der Helius Digital Asset Standard (DAS) API ausliest: Du rufst ein einzelnes Asset ab, listest die NFTs einer Wallet auf, fragst nach Collection oder Ersteller ab, arbeitest mit komprimierten NFTs und Merkle-Proofs, listest Editions auf und liest den Transaktionsverlauf aus. Informationen zu fungiblen tokens – Guthaben, Gesamtmenge, Inhaber und Preise – findest du in der Anleitung zum Abrufen von SPL-tokens. Dieselben Methoden getAsset und getAssetsByOwner unterstützen sowohl NFTs als auch tokens. Diese Seite konzentriert sich auf Workflows für NFTs und Sammlerstücke.

Wann du diese Methoden verwenden solltest

Verwende die Methoden auf dieser Seite, wenn du:

Metadaten, Bild und Attribute eines einzelnen NFTs anzeigst
Alle NFTs einer Wallet für ein Portfolio oder eine Galerie auflistest
Einen Marktplatz oder Explorer mit Abfragen nach Collection und Ersteller betreibst
Komprimierte NFTs verifizierst oder überträgst, wofür Merkle-Proofs erforderlich sind
Den On-Chain-Transaktionsverlauf eines NFTs anzeigst
Die von einem Master-NFT erstellten Editions auflistest

NFT-Methoden

Beginne mit getAsset für ein einzelnes NFT oder mit getAssetsByOwner für den NFT-Bestand einer Wallet. Jede Karte verlinkt auf die vollständige API-Referenz.

getAsset

Vollständige Daten zu einem NFT anhand seiner ID.

getAssetsByOwner

Alle NFTs in einer Wallet.

searchAssets

Filtere nach Collection, Ersteller, Attributen und mehr. Weitere Informationen findest du in der Anleitung zur Asset-Suche.

getAssetsByCreator

Alle von einem Ersteller geprägten Assets.

getAssetsByGroup

Alle Assets in einer Collection.

getSignaturesForAsset

Transaktionsverlauf eines Assets.

getNftEditions

Von einem Master-NFT erstellte Editions.

getAssetProof

Merkle-Proof für ein komprimiertes NFT.

Einzelnes NFT abrufen

Rufe die vollständigen Metadaten, Eigentumsinformationen und Collection-Daten eines NFTs anhand seiner ID ab:

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);

Weitere NFT-Abfragen

List a wallet's NFTs — 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');

By creator — 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');

By 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');

Transaction history — 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');

Komprimierte NFTs

Zustandskomprimierte NFTs (cNFTs) werden mit denselben Methoden wie reguläre NFTs ausgelesen. getAsset, getAssetsByOwner und searchAssets geben sie alle zurück. Zwei Aspekte gelten speziell für die Komprimierung:

Merkle-Proofs – On-Chain-Operationen wie Übertragungen und Burns erfordern einen Proof von getAssetProof.
Verlauf – Verwende getSignaturesForAsset (siehe oben), um den Transaktionsverlauf eines cNFTs abzurufen.

Get a Merkle proof — 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');

Best Practices

Verwende die Paginierung für Methoden, die große Ergebnismengen zurückgeben.
Behandle Fehler mit try/catch und wiederhole vorübergehende Fehlschläge mit exponentiellem Backoff.
Cache responses, wenn es sinnvoll ist, um API-Aufrufe zu reduzieren.
Verwende bei mehreren IDs getAssetBatch statt vieler einzelner Aufrufe von getAsset.

Nächste Schritte

Get SPL Tokens

Guthaben, Gesamtmenge, Inhaber und Preise fungibler tokens.

Search Assets

Filtere NFTs nach Collection, Ersteller und Attributen.

DAS API FAQ

Häufige Fragen zu Assets, Preisdaten und Nutzung.

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

Solana-NFTs abrufen: Assets, Collections und Proofs

Überblick

Wann du diese Methoden verwenden solltest

NFT-Methoden

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

Einzelnes NFT abrufen

Weitere NFT-Abfragen

Komprimierte NFTs

Best Practices

Nächste Schritte

Get SPL Tokens

Search Assets

DAS API FAQ

​Überblick

​Wann du diese Methoden verwenden solltest

​NFT-Methoden

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​Einzelnes NFT abrufen

​Weitere NFT-Abfragen

​Komprimierte NFTs

​Best Practices

​Nächste Schritte

Get SPL Tokens

Search Assets

DAS API FAQ

Überblick

Wann du diese Methoden verwenden solltest

NFT-Methoden

Einzelnes NFT abrufen

Weitere NFT-Abfragen

Komprimierte NFTs

Best Practices

Nächste Schritte