Solana 资产搜索：查找 NFT、代币和压缩资产

概述

searchAssets 是 DAS API 中最灵活的读取方法。它返回符合所有者、集合分组、代币类型和属性等筛选条件的资产，支持单次分页调用。需要多个资产或所有者列表以外时使用。 tokenType 是可选的。如果省略，searchAssets 仅返回常规和压缩的 NFT，不包括同质化代币。要包含同质化代币，请设置 tokenType（例如，"fungible" 或 "all"）。接受的值有 fungible，nonFungible，regularNft，compressedNft，和 all。

何时使用

在以下情况下使用 searchAssets：

过滤钱包资产，仅限同质化代币或仅限 NFT
列出钱包在特定集合中拥有的资产
批量发现压缩的 NFT
使用光标分页在大型结果集上构建无限滚动
按代理状态或签署者过滤 MPL 核心水平的资产

对于单个资产，使用 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

tokenType 是可选的，指定响应中出现的资产类型。如省略，searchAssets 仅返回常规和压缩的 NFT，设定 tokenType 以包含同质化代币。

string

接受的值：fungible，nonFungible，regularNft，compressedNft，all。如果省略，默认为常规和压缩的 NFT。

tokenType	结果	典型用例
`fungible`	仅 SPL 和 Token-2022 代币	钱包余额、代币门控
`nonFungible`	所有 NFT（压缩和常规）	投资组合概览
`regularNft`	传奇和 pNFTs（非压缩）	市场列表
`compressedNft`	仅 cNFTs	超便宜的批量铸造
`all`	所有（代币和 NFT）	全面发现

分页和排序

Solana 钱包可以拥有数千种资产，因此高效分页很重要：

页 / 限制 — 经典分页（page 从 1 开始）。适用于静态视图。
游标 — 从上一个响应传递 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）

你也可以将 interface 设置为 MplCoreAsset、MplCoreCollection 或 MplCoreGroup 以进行 MPL Core 特定的发现。

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

响应字段 is_agent、agent_token 和 asset_signer 在不适用时被省略（例如，当为 false 时，is_agent 被省略）。查看 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拥有的滴水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

交易

发送交易

Wallet-as-a-Service

指南

资源

Solana 资产搜索：查找 NFT、代币和压缩资产

概述

何时使用

API 参考

快速开始

选择 tokenType

分页和排序

显示选项

MPL Core 代理、资产签名者和 MIP-11 组

示例

搜索钱包中的所有同质化代币

下一步

分页

同质化代币扩展

searchAssets参考

​概述

​何时使用

API 参考

​快速开始

​选择 tokenType

​分页和排序

​显示选项

​MPL Core 代理、资产签名者和 MIP-11 组

​示例

​搜索钱包中的所有同质化代币

​下一步

分页

同质化代币扩展

searchAssets参考

概述

何时使用

快速开始

选择 tokenType

分页和排序

显示选项

MPL Core 代理、资产签名者和 MIP-11 组

示例

搜索钱包中的所有同质化代币

下一步