Pencarian Aset Solana: Temukan NFT, Token, & Aset Terkompresi

Ringkasan

searchAssets adalah metode baca paling fleksibel dalam API DAS. Metode ini mengembalikan aset yang cocok dengan kombinasi filter — pemilik, pengelompokan koleksi, jenis token, dan atribut — dalam satu panggilan dengan paginasi. Gunakan metode ini saat Anda membutuhkan lebih dari satu aset atau lebih dari sekadar daftar berdasarkan pemilik. tokenType bersifat opsional. Jika dihilangkan, searchAssets hanya mengembalikan NFT reguler dan terkompresi — tanpa token fungibel. Untuk menyertakan token fungibel, tetapkan tokenType (misalnya, "fungible" atau "all"). Nilai yang diterima adalah fungible, nonFungible, regularNft, compressedNft, dan all.

Kapan menggunakannya

Gunakan searchAssets saat Anda ingin:

Memfilter aset dompet agar hanya menampilkan token fungibel atau hanya NFT
Mencantumkan aset yang dimiliki dompet dalam koleksi tertentu
Menemukan NFT terkompresi secara massal
Membuat gulir tanpa batas untuk kumpulan hasil besar dengan paginasi kursor
Memfilter aset MPL Core berdasarkan status agen atau penanda tangan

Untuk satu aset, gunakan getAsset; untuk daftar dompet sederhana, gunakan getAssetsByOwner.

API Reference

Lihat dokumentasi terperinci untuk searchAssets

Mulai cepat

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

Memilih tokenType

tokenType bersifat opsional dan menentukan jenis aset apa yang muncul dalam respons. Jika dihilangkan, searchAssets hanya mengembalikan NFT reguler dan terkompresi — tetapkan tokenType untuk menyertakan token fungibel.

string

Nilai yang diterima: fungible, nonFungible, regularNft, compressedNft, all. Jika dihilangkan, nilai bawaannya adalah NFT reguler dan terkompresi.

tokenType	Hasil yang Anda dapatkan	Kasus penggunaan umum
`fungible`	Hanya token SPL dan Token-2022	Saldo dompet, pembatasan akses berbasis token
`nonFungible`	Semua NFT (terkompresi dan reguler)	Ringkasan portofolio
`regularNft`	NFT lama dan pNFT (tidak terkompresi)	Daftar marketplace
`compressedNft`	Hanya cNFT	Pencetakan massal berbiaya sangat rendah
`all`	Semuanya (token dan NFT)	Penemuan menyeluruh

Paginasi dan pengurutan

Dompet Solana dapat memiliki ribuan aset, sehingga pemuatan halaman yang efisien sangat penting:

Halaman / batas — paginasi klasik (page dimulai dari 1). Cocok untuk tampilan statis.
Kursor — teruskan nilai before atau after dari respons sebelumnya untuk pengguliran tanpa batas yang cepat.

sortBy

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

Untuk strategi halaman/batas dan kursor secara lengkap, termasuk kueri keyset paralel, lihat panduan Paginasi.

Opsi tampilan

Flag ini menambahkan metadata; flag tersebut tidak pernah mengubah aset yang dikembalikan.

Flag	Efek
`showNativeBalance`	Menyertakan saldo SOL dompet
`showCollectionMetadata`	Menambahkan data JSON tingkat koleksi
`showGrandTotal`	Mengembalikan jumlah total hasil yang cocok (lebih lambat)

options

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

Agen MPL Core, penanda tangan aset, dan grup MIP-11

Aset MPL Core dapat menampilkan metadata identitas agen dan penanda tangan aset, sedangkan aset atau koleksi dapat menyertakan plugin groups (MIP-11) yang menjelaskan keanggotaan grup. Kolom opsional yang sama muncul di setiap metode DAS yang mengembalikan aset (getAsset, getAssetBatch, getAssetsByOwner, getAssetsByGroup, getAssetsByCreator, getAssetsByAuthority, dan setiap item dalam searchAssets). Gunakan searchAssets untuk memfilter berdasarkan status atau alamat agen:

Parameter	Jenis	Tujuan
`isAgent`	boolean	Hanya aset dengan Identitas Agen
`agentToken`	string	Mencocokkan mint token agen (base58)
`assetSigner`	string	Mencocokkan PDA penanda tangan aset (base58)

Anda juga dapat menetapkan interface ke MplCoreAsset, MplCoreCollection, atau MplCoreGroup untuk penemuan khusus MPL Core.

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

Kolom respons is_agent, agent_token, dan asset_signer dihilangkan jika tidak berlaku (misalnya, is_agent dihilangkan jika bernilai false). Lihat referensi API searchAssets untuk skema lengkap.

Contoh

Contoh pertama menunjukkan pembungkus fetch secara lengkap. Contoh lainnya mengikuti pola yang sama dan diciutkan — perluas untuk melihat isi permintaan.

Mencari semua token fungibel dalam dompet

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

Search for fungible tokens with native balance and token info

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

Search for Drip NFTs owned by 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();

Search for compressed assets in a wallet

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

Langkah berikutnya

Pagination

Paginasi berbasis halaman dan keyset untuk kumpulan hasil besar.

Fungible Token Extension

Cara tokenType, saldo, dan harga muncul dalam hasil.

searchAssets reference

Skema permintaan dan respons lengkap.

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

Pencarian Aset Solana: Temukan NFT, Token, & Aset Terkompresi

Ringkasan

Kapan menggunakannya

API Reference

Mulai cepat

Memilih tokenType

Paginasi dan pengurutan

Opsi tampilan

Agen MPL Core, penanda tangan aset, dan grup MIP-11

Contoh

Mencari semua token fungibel dalam dompet

Langkah berikutnya

Pagination

Fungible Token Extension

searchAssets reference

​Ringkasan

​Kapan menggunakannya

API Reference

​Mulai cepat

​Memilih tokenType

​Paginasi dan pengurutan

​Opsi tampilan

​Agen MPL Core, penanda tangan aset, dan grup MIP-11

​Contoh

​Mencari semua token fungibel dalam dompet

​Langkah berikutnya

Pagination

Fungible Token Extension

searchAssets reference

Ringkasan

Kapan menggunakannya

Mulai cepat

Memilih tokenType

Paginasi dan pengurutan

Opsi tampilan

Agen MPL Core, penanda tangan aset, dan grup MIP-11

Contoh

Mencari semua token fungibel dalam dompet

Langkah berikutnya