Recherche d'actifs Solana : Trouver des NFT, des jetons et des actifs compressés

Aperçu

searchAssets est la méthode de lecture la plus flexible dans l’API DAS. Elle retourne les actifs correspondant à une combinaison de filtres — propriétaire, regroupement de collection, type de jeton et attributs — en un seul appel paginé. Utilisez-la dès que vous avez besoin de plus qu’un seul actif ou d’une simple liste par propriétaire. tokenType est optionnel. Lorsqu’il est omis, searchAssets retourne uniquement des NFT réguliers et compressés — pas de jetons fongibles. Pour inclure des jetons fongibles, définissez tokenType (par exemple, "fungible" ou "all"). Les valeurs acceptées sont fungible, nonFungible, regularNft, compressedNft et all.

Quand l’utiliser

Utilisez searchAssets lorsque vous :

Filtrez les actifs d’un portefeuille aux seuls jetons fongibles ou aux seuls NFT
Listez les actifs qu’un portefeuille possède dans une collection spécifique
Découvrez en masse des NFT compressés
Construisez un défilement infini sur de grands ensembles de résultats avec une pagination par curseur
Filtrez les actifs MPL Core par statut d’agent ou signataire

Pour un seul actif, utilisez getAsset ; pour une liste simple de portefeuille, utilisez getAssetsByOwner.

Référence de l'API

Voir la documentation détaillée pour searchAssets

Démarrage rapide

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

Choisir un tokenType

tokenType est optionnel et spécifie quel type d’actifs apparaissent dans la réponse. Lorsqu’il est omis, searchAssets retourne uniquement des NFT réguliers et compressés — définissez tokenType pour inclure des jetons fongibles.

string

Valeurs acceptées : fungible, nonFungible, regularNft, compressedNft, all. Par défaut, retourne des NFT réguliers et compressés lorsqu’il est omis.

tokenType	Ce que vous obtenez	Cas d’utilisation typique
`fungible`	Jetons SPL et Token-2022 uniquement	Soldes de portefeuille, accès par jetons
`nonFungible`	Tous les NFT (compressés et réguliers)	Aperçu de portefeuille
`regularNft`	Legacy et pNFT (non compressés)	Annonces de marché
`compressedNft`	Seulement cNFT	Mises en circulation massives ultra-économiques
`all`	Tout (jetons et NFT)	Découverte exhaustive

Pagination et tri

Les portefeuilles Solana peuvent posséder des milliers d’actifs, donc une pagination efficace est importante :

Page / limite — pagination classique (page commence à 1). Utile pour les vues statiques.
Curseur — passez before ou after des valeurs de la réponse précédente pour un défilement infini rapide.

sortBy

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

Pour des stratégies complètes de pagination par page/limite et par curseur, y compris l’interrogation parallèle avec clés, consultez le guide de pagination.

Options d’affichage

Ces indicateurs ajoutent des métadonnées ; ils ne modifient jamais les actifs retournés.

Indicateur	Effet
`showNativeBalance`	Inclut le solde SOL du portefeuille
`showCollectionMetadata`	Ajoute des données JSON au niveau de la collection
`showGrandTotal`	Retourne le nombre total de correspondances (plus lent)

options

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

Agents MPL Core, signataires d’actifs et groupes MIP-11

Les actifs MPL Core peuvent exposer des métadonnées d’identité d’agent et de signataire d’actif, et les actifs ou collections peuvent inclure un groups plugin (MIP-11) décrivant l’appartenance à un groupe. Les mêmes champs optionnels apparaissent sur chaque méthode de retour d’actif DAS (getAsset, getAssetBatch, getAssetsByOwner, getAssetsByGroup, getAssetsByCreator, getAssetsByAuthority, et chaque élément dans searchAssets). Utilisez searchAssets pour filtrer par statut d’agent ou adresses :

Paramètre	Type	But
`isAgent`	booléen	Uniquement les actifs avec une identité d’agent
`agentToken`	chaîne	Correspondance de la frappe de jeton d’agent (base58)
`assetSigner`	chaîne	Correspondance de signataire d’actif PDA (base58)

Vous pouvez également définir interface à MplCoreAsset, MplCoreCollection, ou MplCoreGroup pour une découverte spécifique à MPL Core.

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

Les champs de réponse is_agent, agent_token, et asset_signer sont omis lorsque non applicables (par exemple, is_agent est omis lorsqu’il est faux). Voir la référence API searchAssets pour les schémas complets.

Exemples

Le premier exemple montre le wrapper complet fetch. Les exemples restants suivent le même modèle et sont réduits — développez-les pour le corps de la demande.

Rechercher tous les jetons fongibles dans un portefeuille

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

Rechercher des jetons fongibles avec solde natif et informations sur les jetons

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

Rechercher des NFT Drip détenus par 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();

Rechercher des actifs compressés dans un portefeuille

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

Prochaines étapes

Pagination

Pagination par page et par clés pour de grands ensembles de résultats.

Extension de jeton fongible

Comment tokenType, soldes et prix apparaissent dans les résultats.

référence searchAssets

Schémas de requêtes et réponses complets.

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

Recherche d'actifs Solana : Trouver des NFT, des jetons et des actifs compressés

Aperçu

Quand l’utiliser

Référence de l'API

Démarrage rapide

Choisir un tokenType

Options d’affichage

Agents MPL Core, signataires d’actifs et groupes MIP-11

Exemples

Rechercher tous les jetons fongibles dans un portefeuille

Prochaines étapes

Pagination

Extension de jeton fongible

référence searchAssets

​Aperçu

​Quand l’utiliser

Référence de l'API

​Démarrage rapide

​Choisir un tokenType

​Pagination et tri

​Options d’affichage

​Agents MPL Core, signataires d’actifs et groupes MIP-11

​Exemples

​Rechercher tous les jetons fongibles dans un portefeuille

​Prochaines étapes

Pagination

Extension de jeton fongible

référence searchAssets

Aperçu

Quand l’utiliser

Démarrage rapide

Choisir un tokenType

Pagination et tri

Options d’affichage

Agents MPL Core, signataires d’actifs et groupes MIP-11

Exemples

Rechercher tous les jetons fongibles dans un portefeuille

Prochaines étapes