Solana-Asset-Suche: NFTs, Tokens und komprimierte Assets finden

Übersicht

searchAssets ist die flexibelste Lesemethode der DAS API. Sie gibt Assets zurück, die einer Kombination von Filtern entsprechen – Eigentümer, Sammlungsgruppierung, Token-Typ und Attribute – und fasst sie in einem einzigen paginierten Aufruf zusammen. Verwende sie immer dann, wenn du mehr als ein einzelnes Asset oder eine einfache Liste nach Eigentümer benötigst. tokenType ist optional. Wenn du den Wert weglässt, gibt searchAssets nur reguläre und komprimierte NFTs zurück – keine fungiblen Tokens. Um fungible Tokens einzuschließen, setze tokenType, zum Beispiel auf "fungible" oder "all". Zulässige Werte sind fungible, nonFungible, regularNft, compressedNft und all.

Wann du diese Methode verwenden solltest

Verwende searchAssets in folgenden Fällen:

Du filterst die Assets einer Wallet nach fungiblen Tokens oder NFTs
Du listest die Assets auf, die eine Wallet innerhalb einer bestimmten Sammlung besitzt
Du suchst große Mengen komprimierter NFTs
Du implementierst unendliches Scrollen für große Ergebnismengen mit Cursor-Paginierung
Du filterst MPL Core Assets nach Agentenstatus oder Signer

Verwende für einzelne Assets getAsset und für eine einfache Wallet-Liste getAssetsByOwner.

API Reference

Sieh dir die ausführliche Dokumentation für searchAssets an

Schnellstart

// Replace YOUR_API_KEY with your Helius API key
const url = `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`;

async function searchAssets(params) {
  const body = {
    jsonrpc: "2.0",
    id: "search-assets-example",
    method: "searchAssets",
    params,
  };
  const res = await fetch(url, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
  if (!res.ok) {
    throw new Error(`${res.status} ${res.statusText}`);
  }
  const { result } = await res.json();
  return result;
}

// Example: fetch first 50 compressed NFTs in a wallet
searchAssets({
  ownerAddress: "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  tokenType: "compressedNft",
  limit: 50,
}).then(console.log);

Einen tokenType auswählen

tokenType ist optional und legt fest, welche Art von Assets in der response erscheint. Wenn du den Wert weglässt, gibt searchAssets nur reguläre und komprimierte NFTs zurück. Setze tokenType, um fungible Tokens einzuschließen.

string

Zulässige Werte: fungible, nonFungible, regularNft, compressedNft, all. Wenn du den Wert weglässt, werden standardmäßig reguläre und komprimierte NFTs zurückgegeben.

tokenType	Ergebnis	Typischer Anwendungsfall
`fungible`	Nur SPL- und Token-2022-Tokens	Wallet-Guthaben, Token-Gating
`nonFungible`	Alle NFTs (komprimiert und regulär)	Portfolioübersicht
`regularNft`	Legacy-NFTs und pNFTs (unkomprimiert)	Marketplace-Angebote
`compressedNft`	Nur cNFTs	Besonders kostengünstige Massenprägungen
`all`	Alles (Tokens und NFTs)	Umfassende Suche

Paginierung und Sortierung

Solana-Wallets können Tausende Assets enthalten. Daher ist eine effiziente Paginierung wichtig:

Seite / Limit – klassische Paginierung (page beginnt bei 1). Geeignet für statische Ansichten.
Cursor – übergib die Werte before oder after aus der vorherigen response, um schnelles, unendliches Scrollen zu ermöglichen.

sortBy

"sortBy": {
  "sortBy": "created",      // created | recent_action | updated | none
  "sortDirection": "desc"   // asc | desc
}

Vollständige Strategien für Seite/Limit und Cursor, einschließlich paralleler Keyset-Abfragen, findest du im Leitfaden zur Paginierung.

Anzeigeoptionen

Diese Flags fügen Metadaten hinzu. Sie ändern nicht, welche Assets zurückgegeben werden.

Flag	Wirkung
`showNativeBalance`	Schließt das SOL-Guthaben der Wallet ein
`showCollectionMetadata`	Fügt JSON-Daten auf Sammlungsebene hinzu
`showGrandTotal`	Gibt die Gesamtzahl der Treffer zurück (langsamer)

options

"options": {
  "showNativeBalance": true,
  "showCollectionMetadata": true,
  "showGrandTotal": true
}

MPL Core Agents, Asset-Signer und MIP-11-Gruppen

MPL Core Assets können Metadaten zur Agentenidentität und zum Asset-Signer bereitstellen. Assets oder Sammlungen können außerdem ein groups-Plugin (MIP-11) enthalten, das die Gruppenzugehörigkeit beschreibt. Dieselben optionalen Felder erscheinen bei jeder DAS-Methode, die Assets zurückgibt (getAsset, getAssetBatch, getAssetsByOwner, getAssetsByGroup, getAssetsByCreator, getAssetsByAuthority und jedes Element in searchAssets). Verwende searchAssets, um nach Agentenstatus oder Adressen zu filtern:

Parameter	Typ	Zweck
`isAgent`	boolean	Nur Assets mit einer Agentenidentität
`agentToken`	string	Nach Agent-Token-Mint abgleichen (base58)
`assetSigner`	string	Nach Asset-Signer-PDA abgleichen (base58)

Für eine MPL-Core-spezifische Suche kannst du interface auch auf MplCoreAsset, MplCoreCollection oder MplCoreGroup setzen.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "searchAssets",
  "params": {
    "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
    "tokenType": "all",
    "isAgent": true,
    "page": 1,
    "limit": 10
  }
}

Die response-Felder is_agent, agent_token und asset_signer werden weggelassen, wenn sie nicht zutreffen. Beispielsweise wird is_agent weggelassen, wenn der Wert falsch ist. Vollständige Schemas findest du in der searchAssets API-Referenz.

Beispiele

Das erste Beispiel zeigt den vollständigen fetch-Wrapper. Die übrigen Beispiele folgen demselben Muster und sind eingeklappt. Klappe sie aus, um den request-Body anzuzeigen.

Nach allen fungiblen Tokens in einer Wallet suchen

const url = `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

const searchAssets = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'searchAssets',
      params: {
        ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
        tokenType: 'fungible',
      },
    }),
  });
  const { result } = await response.json();
  console.log("Search Assets: ", result);
};
searchAssets();

Search for fungible tokens with native balance and token info

const url = `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

const searchAssetsTokenInfo = async () => {
    const response = await fetch(url, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            jsonrpc: '2.0',
            id: 'my-id',
            method: 'searchAssets',
            params: {
                ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
                tokenType: 'fungible',
                options: {
                    showNativeBalance: true,
                },
            },
        }),
    });

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

    result.items.forEach(item => {
      console.log(item.token_info);
    });

    console.log("Native Balance: ", result.nativeBalance);
};

searchAssetsTokenInfo();

Search for Drip NFTs owned by vibhu.sol

const url = `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

const searchAssetsDrip = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'searchAssets',
      params: {
        ownerAddress: 'BAVjpySHMMGDpq3whU7qaqCCRE8ksCeGwxa53Qv2i8jS',
        grouping: ["collection", "DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x"],
        page: 1,
        limit: 1000
      },
    }),
  });
  const { result } = await response.json();
  console.log("Drip Haus Assets: ", result);
};
searchAssetsDrip();

Search for compressed assets in a wallet

const url = `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

const searchAssetsCompressed = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'searchAssets',
      params: {
        ownerAddress: '2k5AXX4guW9XwRQ1AKCpAuUqgWDpQpwFfpVFh3hnm2Ha',
        compressed: true,
      },
    }),
  });
  const { result } = await response.json();
  console.log("Search Assets: ", result);
};
searchAssetsCompressed();

Nächste Schritte

Pagination

Seitenbasierte und Keyset-Paginierung für große Ergebnismengen.

Fungible Token Extension

So erscheinen tokenType, Guthaben und Preise in den Ergebnissen.

searchAssets reference

Vollständige request- und response-Schemas.

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

Solana-Asset-Suche: NFTs, Tokens und komprimierte Assets finden

Übersicht

Wann du diese Methode verwenden solltest

API Reference

Schnellstart

Einen tokenType auswählen

Paginierung und Sortierung

Anzeigeoptionen

MPL Core Agents, Asset-Signer und MIP-11-Gruppen

Beispiele

Nach allen fungiblen Tokens in einer Wallet suchen

Nächste Schritte

Pagination

Fungible Token Extension

searchAssets reference

​Übersicht

​Wann du diese Methode verwenden solltest

API Reference

​Schnellstart

​Einen tokenType auswählen

​Paginierung und Sortierung

​Anzeigeoptionen

​MPL Core Agents, Asset-Signer und MIP-11-Gruppen

​Beispiele

​Nach allen fungiblen Tokens in einer Wallet suchen

​Nächste Schritte

Pagination

Fungible Token Extension

searchAssets reference

Übersicht

Wann du diese Methode verwenden solltest

Schnellstart

Einen tokenType auswählen

Paginierung und Sortierung

Anzeigeoptionen

MPL Core Agents, Asset-Signer und MIP-11-Gruppen

Beispiele

Nach allen fungiblen Tokens in einer Wallet suchen

Nächste Schritte