Solanaアセット検索: NFT、トークン、圧縮アセットを探す

概要

searchAssets は、DAS APIで最も柔軟な読み取りメソッドです。所有者、コレクションのグループ化、トークンタイプ、属性の組み合わせに一致するアセットを1回のページネーションされたコールで返します。単一のアセット以上または所有者ごとの単純なリストが必要なときに使用します。 tokenType はオプションです。省略された場合、searchAssets は通常のNFTと圧縮NFTのみを返し、代替可能トークンは含まれません。代替可能トークンを含めるには、tokenType を設定します（例えば、"fungible" または "all"）。受け入れられる値は、fungible、nonFungible、regularNft、compressedNft、all です。

いつ使用するか

次の場合に searchAssets を使用します:

ウォレットのアセットを代替可能トークンまたはNFTにフィルタリングする
特定のコレクション内でウォレットが所有するアセットをリストする
大量の圧縮NFTを発見する
カーソルページネーションで大きな結果セットに無限スクロールを構築する
エージェントステータスまたは署名者でMPL Coreアセットをフィルタリングする

単一のアセットにはgetAssetを、単純なウォレットリストにはgetAssetsByOwnerを使用します。

APIリファレンス

searchAssetsの詳細なドキュメントを表示

クイックスタート

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

トークンタイプの選択

tokenType はオプションで、レスポンスに現れる資産の種類を指定します。省略された場合、searchAssets は通常および圧縮NFTのみを返します。代替可能トークンを含めるには、tokenType を設定します。

tokenType

string

受け入れられる値: fungible、nonFungible、regularNft、compressedNft、all。省略時は通常および圧縮NFTがデフォルトです。

tokenType	得られるもの	一般的な使用ケース
`fungible`	SPLとToken-2022トークンのみ	ウォレット残高、トークンゲーティング
`nonFungible`	全てのNFT（圧縮と通常）	ポートフォリオの概要
`regularNft`	レガシーとpNFT（非圧縮）	マーケットプレイスのリスト
`compressedNft`	cNFTのみ	非常に安価な大量ミント
`all`	すべて（トークンとNFT）	包括的な発見

ページネーションとソート

Solanaウォレットは数千のアセットを所有できるため、効率的なページ処理が重要です:

Page / limit — クラシックなページネーション (page は1から始まります)。静的ビューに適しています。
Cursor — 以前のレスポンスからbeforeまたはafterを渡して、迅速な無限スクロールを実現します。

sortBy

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

完全なページ/リミットとカーソル戦略、並列キーセットクエリを含む詳細はページネーションガイドを参照してください。

表示オプション

これらのフラグはメタデータを追加します; アセットの返却には影響しません。

フラグ	効果
`showNativeBalance`	ウォレットのSOL残高を含める
`showCollectionMetadata`	コレクションレベルのJSONデータを追加
`showGrandTotal`	合計一致件数を返す（遅くなります）

options

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

MPL Coreエージェント、アセットサイナー、およびMIP-11グループ

MPL Coreアセットは、エージェントの身元およびアセットサイナーのメタデータを公開することができ、アセットまたはコレクションはグループメンバーシップを説明する**groupsプラグイン**（MIP-11）を含むことがあります。同じオプションフィールドは、すべてのアセット返却DASメソッド（getAsset、getAssetBatch、getAssetsByOwner、getAssetsByGroup、getAssetsByCreator、getAssetsByAuthority、およびsearchAssetsの各項目）で表示されます。エージェントステータスまたはアドレスでフィルタリングするには、searchAssetsを使用します:

パラメータ	タイプ	目的
`isAgent`	boolean	エージェントアイデンティティを持つアセットのみ
`agentToken`	string	エージェントトークンミント(base58)にマッチする
`assetSigner`	string	アセットサイナーPDA(base58)にマッチします

MPL Core固有の発見には、interfaceをMplCoreAsset、MplCoreCollection、またはMplCoreGroupに設定することもできます。

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

レスポンスフィールドis_agent、agent_token、asset_signerは該当しないときは省略されます（例えば、is_agentがfalseのときに省略されます）。完全なスキーマについてはsearchAssets APIリファレンスを参照してください。

例

最初の例は、完全なfetchラッパーを示しています。残りの例は同じパターンに従い折りたたまれています — リクエストボディを展開してください。

ウォレット内のすべての代替可能トークンを検索する

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

ネイティブバランスとトークン情報を持つ代替可能トークンを検索

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

vibhu.solが所有するDrip NFTを検索

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

ウォレット内の圧縮アセットを検索

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

次のステップ

ページネーション

大規模な結果セットのためのページベースとキーセットページネーション。

代替可能トークン拡張

tokenType、残高、価格が結果にどのように表示されるか。

searchAssetsリファレンス

完全なリクエストとレスポンスのスキーマ。

はじめに

データストリーミングとイベントリスニング

データ API & RPC

トレーディング

トランザクションの送信

ウォレット・アズ・ア・サービス

ガイド

リソース

Solanaアセット検索: NFT、トークン、圧縮アセットを探す

概要

いつ使用するか

APIリファレンス

クイックスタート

トークンタイプの選択

ページネーションとソート

表示オプション

MPL Coreエージェント、アセットサイナー、およびMIP-11グループ

例

ウォレット内のすべての代替可能トークンを検索する

次のステップ

ページネーション

代替可能トークン拡張

searchAssetsリファレンス

​概要

​いつ使用するか

APIリファレンス

​クイックスタート

​トークンタイプの選択

​ページネーションとソート

​表示オプション

​MPL Coreエージェント、アセットサイナー、およびMIP-11グループ

​例

​ウォレット内のすべての代替可能トークンを検索する

​次のステップ

ページネーション

代替可能トークン拡張

searchAssetsリファレンス

概要

いつ使用するか

クイックスタート

トークンタイプの選択

ページネーションとソート

表示オプション

MPL Coreエージェント、アセットサイナー、およびMIP-11グループ

例

ウォレット内のすべての代替可能トークンを検索する

次のステップ