Cara Mendapatkan NFT Solana: Aset, Koleksi & Bukti

Ikhtisar

Panduan ini membahas cara membaca NFT dan koleksi digital dengan Helius Digital Asset Standard (DAS) API: mengambil satu aset, mencantumkan NFT milik dompet, membuat kueri berdasarkan koleksi atau kreator, menangani NFT terkompresi dan bukti Merkle, mencantumkan edisi, serta membaca riwayat transaksi. Untuk token fungibel — saldo, suplai, pemegang, dan harga — lihat panduan Mendapatkan Token SPL. Metode getAsset dan getAssetsByOwner yang sama mendukung NFT maupun token; halaman ini berfokus pada alur kerja NFT dan barang koleksi.

Kapan menggunakannya

Gunakan metode di halaman ini saat Anda ingin:

Menampilkan metadata, gambar, dan atribut satu NFT
Mencantumkan setiap NFT yang dimiliki dompet untuk portofolio atau galeri
Mendukung marketplace atau penjelajah dengan kueri koleksi dan kreator
Memverifikasi atau mentransfer NFT terkompresi (yang memerlukan bukti Merkle)
Menampilkan riwayat transaksi on-chain NFT
Mencantumkan edisi yang dicetak dari NFT master

Metode NFT

Mulai dengan getAsset untuk satu NFT atau getAssetsByOwner untuk koleksi milik dompet. Setiap kartu tertaut ke referensi API lengkapnya.

getAsset

Data lengkap untuk satu NFT berdasarkan ID-nya.

getAssetsByOwner

Semua NFT yang disimpan dalam dompet.

searchAssets

Filter berdasarkan koleksi, kreator, atribut, dan lainnya — lihat panduan Pencarian Aset.

getAssetsByCreator

Semua aset yang dicetak oleh kreator.

getAssetsByGroup

Semua aset dalam koleksi.

getSignaturesForAsset

Riwayat transaksi untuk suatu aset.

getNftEditions

Edisi yang dicetak dari NFT master.

getAssetProof

Bukti Merkle untuk NFT terkompresi.

Ambil satu NFT

Ambil metadata lengkap, kepemilikan, dan data koleksi untuk satu NFT berdasarkan ID-nya:

const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAsset',
    params: { id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk' },
  }),
});

const { result } = await response.json();
console.log(result.content.metadata.name, result.ownership.owner);

Kueri NFT lainnya

List a wallet's NFTs — getAssetsByOwner

const getNFTsByOwner = async (ownerAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByOwner',
      params: { ownerAddress, page: 1, limit: 10 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTsByOwner('86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY');

By creator — getAssetsByCreator

const getAssetsByCreator = async (creatorAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByCreator',
      params: { creatorAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCreator('9uBX3ASjxWvNBAD1xjbVaKA74mWGZys3RGSF7DdeDD3F');

By collection — getAssetsByGroup

const getAssetsByCollection = async (collectionAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByGroup',
      params: { groupKey: 'collection', groupValue: collectionAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCollection('J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w');

Transaction history — getSignaturesForAsset

const getNFTTransactionHistory = async (mintAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getSignaturesForAsset',
      params: { id: mintAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTTransactionHistory('FNt6A9Mfnqbwc1tY7uwAguKQ1JcpBrxmhczDgbdJy5AC');

NFT terkompresi

NFT dengan kompresi status (cNFT) dibaca menggunakan metode yang sama seperti NFT biasa — getAsset, getAssetsByOwner, dan searchAssets semuanya mengembalikan NFT tersebut. Ada dua hal yang khusus untuk kompresi:

Bukti Merkle — operasi on-chain seperti transfer dan pembakaran memerlukan bukti dari getAssetProof.
Riwayat — gunakan getSignaturesForAsset (ditampilkan di atas) untuk riwayat transaksi cNFT.

Get a Merkle proof — getAssetProof

const getProof = async (id) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetProof',
      params: { id },
    }),
  });

  const { result } = await response.json();
  return result; // { root, proof, node_index, leaf, tree_id }
};

getProof('Bu1DEKeawy7txbnCEJE4BU3BKLXaNAKCYcHR4XhndGss');

Praktik terbaik

Gunakan paginasi untuk metode yang mengembalikan kumpulan hasil berukuran besar.
Tangani kesalahan dengan try/catch dan coba ulang kegagalan sementara menggunakan exponential backoff.
Simpan respons dalam cache jika sesuai untuk mengurangi panggilan API.
Gunakan getAssetBatch sebagai pengganti banyak panggilan tunggal getAsset jika Anda memiliki beberapa ID.

Langkah berikutnya

Get SPL Tokens

Saldo, suplai, pemegang, dan harga token fungibel.

Search Assets

Filter NFT berdasarkan koleksi, kreator, dan atribut.

DAS API FAQ

Pertanyaan umum tentang aset, data harga, dan penggunaan.

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

Cara Mendapatkan NFT Solana: Aset, Koleksi & Bukti

Ikhtisar

Kapan menggunakannya

Metode NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

Ambil satu NFT

Kueri NFT lainnya

NFT terkompresi

Praktik terbaik

Langkah berikutnya

Get SPL Tokens

Search Assets

DAS API FAQ

​Ikhtisar

​Kapan menggunakannya

​Metode NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​Ambil satu NFT

​Kueri NFT lainnya

​NFT terkompresi

​Praktik terbaik

​Langkah berikutnya

Get SPL Tokens

Search Assets

DAS API FAQ

Ikhtisar

Kapan menggunakannya

Metode NFT

Ambil satu NFT

Kueri NFT lainnya

NFT terkompresi

Praktik terbaik

Langkah berikutnya