Wie man Solana NFTs erhält: Assets, Sammlungen & Nachweise

Überblick

Dieser Leitfaden behandelt das Lesen von NFTs und digitalen Sammlerstücken mit der Helius Digital Asset Standard (DAS) API: Abrufen eines einzelnen Assets, Auflisten der NFTs eines Wallets, Abfragen nach Sammlung oder Ersteller, Umgang mit komprimierten NFTs und Merkle-Nachweisen, Auflisten von Editionen und Lesen des Transaktionsverlaufs. Für fungible Token — Salden, Angebot, Inhaber und Preise — siehe den Get SPL Tokens-Leitfaden. Die gleichen getAsset und getAssetsByOwner Methoden dienen sowohl NFTs als auch Tokens; diese Seite konzentriert sich auf die NFT- und Sammler-Workflows.

Wann man dies verwendet

Verwenden Sie die Methoden auf dieser Seite, wenn Sie:

Metadaten, Bild und Attribute eines einzelnen NFTs anzeigen
Jedes NFT, das ein Wallet für ein Portfolio oder eine Galerie besitzt, auflisten
Einen Marktplatz oder Explorer mit Sammlungs- und Erstellerabfragen betreiben
Komprimierte NFTs verifizieren oder übertragen (die Merkle-Nachweise erfordern)
Den On-Chain-Transaktionsverlauf eines NFTs anzeigen
Die Editionen auflisten, die aus einem Haupt-NFT gedruckt wurden

NFT-Methoden

Beginnen Sie mit getAsset für ein einzelnes NFT oder getAssetsByOwner für die Sammlung eines Wallets. Jede Karte verlinkt auf ihre vollständige API-Referenz.

getAsset

Vollständige Daten für ein NFT nach seiner ID.

getAssetsByOwner

Alle von einem Wallet gehaltenen NFTs.

searchAssets

Filtern nach Sammlung, Ersteller, Attributen und mehr — siehe den Leitfaden “Search Assets”.

getAssetsByCreator

Alle von einem Ersteller geminten Assets.

getAssetsByGroup

Alle Assets in einer Sammlung.

getSignaturesForAsset

Transaktionsverlauf für ein Asset.

getNftEditions

Editionen, die aus einem Haupt-NFT gedruckt wurden.

getAssetProof

Merkle-Nachweis für ein komprimiertes NFT.

Ein einzelnes NFT abrufen

Vollständige Metadaten, Besitz- und Sammlungsdaten für ein NFT nach seiner ID abrufen:

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

NFTs eines Wallets auflisten — 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');

Nach Ersteller — 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');

Nach Sammlung — 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');

Transaktionsverlauf — 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

State-komprimierte NFTs (cNFTs) werden gelesen mit den gleichen Methoden wie reguläre NFTs — getAsset, getAssetsByOwner, und searchAssets geben sie alle zurück. Zwei Dinge sind spezifisch für die Komprimierung:

Merkle-Nachweise — On-Chain-Operationen wie Transfers und Burns erfordern einen Nachweis von getAssetProof.
Verlauf — Verwenden Sie getSignaturesForAsset (oben gezeigt) für den Transaktionsverlauf eines cNFTs.

Einen Merkle-Nachweis erhalten — 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

Verwenden Sie Pagination für Methoden, die große Ergebnismengen zurückgeben.
Behandeln Sie Fehler mit try/catch und wiederholen Sie vorübergehende Fehler mit exponentiellem Backoff.
Zwischenspeichern Sie Antworten, wenn angebracht, um API-Aufrufe zu reduzieren.
Verwenden Sie getAssetBatch anstelle vieler einzelner getAsset Aufrufe, wenn Sie mehrere IDs haben.

Nächste Schritte

SPL Tokens abrufen

Salden, Angebot, Inhaber und Preise für fungible Tokens.

Assets durchsuchen

Filtern von NFTs nach Sammlung, Ersteller und Attributen.

DAS API FAQ

Häufige Fragen zu Assets, Preisdaten und Nutzung.

Erste Schritte

Daten-Streaming & Ereignisüberwachung

Daten-APIs & RPCs

Handel

Transaktionen senden

Wallet-as-a-Service

Privatsphäre

Ressourcen

Wie man Solana NFTs erhält: Assets, Sammlungen & Nachweise

Überblick

Wann man dies verwendet

NFT-Methoden

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

Ein einzelnes NFT abrufen

Weitere NFT-Abfragen

Komprimierte NFTs

Best Practices

Nächste Schritte

SPL Tokens abrufen

Assets durchsuchen

DAS API FAQ

​Überblick

​Wann man dies verwendet

​NFT-Methoden

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​Ein einzelnes NFT abrufen

​Weitere NFT-Abfragen

​Komprimierte NFTs

​Best Practices

​Nächste Schritte

SPL Tokens abrufen

Assets durchsuchen

DAS API FAQ

Überblick

Wann man dies verwendet

NFT-Methoden

Ein einzelnes NFT abrufen

Weitere NFT-Abfragen

Komprimierte NFTs

Best Practices

Nächste Schritte