Solana 자산 검색: NFT, 토큰 및 압축 자산 찾기

개요

searchAssets는 DAS API에서 가장 유연한 읽기 방법입니다. 소유자, 컬렉션 그룹화, 토큰 유형 및 속성의 조합과 일치하는 자산을 단일 페이지 매김 호출로 반환합니다. 여러 개의 자산이나 단순한 소유자 목록 이상이 필요할 때 사용하십시오. tokenType는 선택 사항입니다. 생략하면, searchAssets는 정규 및 압축된 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 선택

tokenType는 선택 사항이며 응답에 표시되는 자산의 종류를 지정합니다. 생략하면, searchAssets는 정규 및 압축된 NFT만 반환합니다 — 대체 가능한 토큰을 포함하려면 tokenType를 설정하십시오.

string

허용되는 값: fungible, nonFungible, regularNft, compressedNft, all. 생략 시 기본값은 정규 및 압축된 NFT입니다.

tokenType	얻을 수 있는 것	일반적인 사용 사례
`fungible`	SPL 및 Token-2022 토큰만	지갑 잔액, 토큰 게이팅
`nonFungible`	모든 NFT(압축 및 정규)	포트폴리오 개요
`regularNft`	레거시 및 pNFT(비압축)	마켓플레이스 목록
`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 코어 에이전트, 자산 서명자 및 MIP-11 그룹

MPL 코어 자산은 에이전트 신원 및 자산 서명자 메타데이터를 노출할 수 있으며, 자산이나 컬렉션은 그룹 멤버십을 설명하는 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는 적용되지 않을 때 생략됩니다 (예를 들어, 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 참고 자료

빠른 시작

tokenType 선택

페이지 매김 및 정렬

디스플레이 옵션

MPL 코어 에이전트, 자산 서명자 및 MIP-11 그룹

예제

지갑의 모든 대체 가능한 토큰 검색

다음 단계

페이지 매김

대체 가능한 토큰 확장

searchAssets 참조

​개요

​사용 시기

API 참고 자료

​빠른 시작

​tokenType 선택

​페이지 매김 및 정렬

​디스플레이 옵션

​MPL 코어 에이전트, 자산 서명자 및 MIP-11 그룹

​예제

​지갑의 모든 대체 가능한 토큰 검색

​다음 단계

페이지 매김

대체 가능한 토큰 확장

searchAssets 참조

개요

사용 시기

빠른 시작

tokenType 선택

페이지 매김 및 정렬

디스플레이 옵션

MPL 코어 에이전트, 자산 서명자 및 MIP-11 그룹

예제

지갑의 모든 대체 가능한 토큰 검색

다음 단계