跳转到主要内容

API 参考

查看 searchAssets 的详细文档

​
快速开始

必需参数：每个 searchAssets 请求必须包含一个 tokenType。选择以下之一： fungible、nonFungible、regularNft、compressedNft 或 all。
TypeScript
// 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);
page 参数从 1 开始。为了实现极快的无限滚动，请使用游标分页（before/after）。

​
核心概念

​
1. 选择 tokenType

​
tokenType
string
必填
一个必需的字符串，指定您希望在响应中获得哪种资产。
可接受的值：fungible、nonFungible、regularNft、compressedNft、all。
tokenType您得到的典型用例
fungible仅限 SPL 和 Token-22 代币钱包余额，代币门控
nonFungible所有 NFT（压缩和常规）资产组合概览
regularNft传统和 pNFT（未压缩）市场列表
compressedNft仅限 cNFT超低成本批量铸造
all所有内容（代币和 NFT）全面发现

​
2. 分页和排序

Solana 钱包可以拥有数千个资产——高效的分页很重要。
  • 页面/限制 – 经典分页（page 从 1 开始）。适用于静态视图。
  • 光标 – 传递上次响应中的 before 或 after 值，用于快速无限滚动。
"sortBy": {
  "sortBy": "created",      // created | recent_action | updated | none
  "sortDirection": "desc"   // asc | desc
}
有关 page/limit 和基于游标的策略的完整代码示例，请访问专门的分页指南。

​
3. 显示选项 (options)

这些标志添加元数据；它们从不改变返回的资产。
标志效果
showNativeBalance包括钱包的 SOL 余额
showCollectionMetadata添加集合级别的 JSON 数据
showGrandTotal返回总匹配计数（较慢）
showInscription附加铭文和 SPL-20 信息（实验性）
"options": {
  "showNativeBalance": true,
  "showCollectionMetadata": true,
  "showGrandTotal": true,
  "showInscription": true
}

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

MPL Core 资产可以展示代理身份和资产签名者元数据，资产或集合可以包含描述组成员身份的 groups 插件（MIP-11）。在每个资产返回的 DAS 方法中显示相同的可选字段（getAsset，getAssetBatch，getAssetsByOwner，getAssetsByGroup，getAssetsByCreator，getAssetsByAuthority，每个项在 searchAssets 中）。 使用 searchAssets 根据代理状态或地址进行筛选：
参数类型目的
isAgent布尔值仅包含具有代理身份的资产
agentToken字符串匹配代理代币铸造（base58）
assetSigner字符串匹配资产签名者 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 在不适用时省略（例如，is_agent 在为 false 时省略）。完整的模式请参见 searchAssets API参考。

​
代码示例

​
搜索钱包中所有可替代代币

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',
                displayOptions: {
                    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 NFTs

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

​
搜索铭文和 SPL-20 数据

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

const searchAssetsInscriptions = 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: '6GmTFg5SCs4zGfDEidUAJjS5pSrXEPwW8Rpfs3RHrbc5',
                tokenType: 'regularNft',
                displayOptions: {
                    showInscription: true,
                },
            },
        }),
    });

    const { result } = await response.json();
    console.log(result.items.map((i) => [i.id, i.inscription, i.spl20]));
};
searchAssetsInscriptions();