> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cara Mendapatkan NFT Solana: Aset, Koleksi & Bukti

> Ambil dan kueri NFT Solana, NFT terkompresi, edisi, dan bukti menggunakan Helius DAS API. Panduan lengkap dengan contoh kode dan praktik terbaik.

## 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](/docs/id/das/get-tokens). 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.

<CardGroup cols={2}>
  <Card title="getAsset" icon="image" href="/docs/id/api-reference/das/getasset">
    Data lengkap untuk satu NFT berdasarkan ID-nya.
  </Card>

  <Card title="getAssetsByOwner" icon="wallet" href="/docs/id/api-reference/das/getassetsbyowner">
    Semua NFT yang disimpan dalam dompet.
  </Card>

  <Card title="searchAssets" icon="magnifying-glass" href="/docs/id/das/search">
    Filter berdasarkan koleksi, kreator, atribut, dan lainnya — lihat panduan Pencarian Aset.
  </Card>

  <Card title="getAssetsByCreator" icon="user" href="/docs/id/api-reference/das/getassetsbycreator">
    Semua aset yang dicetak oleh kreator.
  </Card>

  <Card title="getAssetsByGroup" icon="layer-group" href="/docs/id/api-reference/das/getassetsbygroup">
    Semua aset dalam koleksi.
  </Card>

  <Card title="getSignaturesForAsset" icon="clock-rotate-left" href="/docs/id/api-reference/das/getsignaturesforasset">
    Riwayat transaksi untuk suatu aset.
  </Card>

  <Card title="getNftEditions" icon="copy" href="/docs/id/api-reference/das/getnfteditions">
    Edisi yang dicetak dari NFT master.
  </Card>

  <Card title="getAssetProof" icon="shield-check" href="/docs/id/api-reference/das/getassetproof">
    Bukti Merkle untuk NFT terkompresi.
  </Card>
</CardGroup>

### Ambil satu NFT

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

```typescript theme={"system"}
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

<AccordionGroup>
  <Accordion title="List a wallet's NFTs — getAssetsByOwner">
    ```typescript theme={"system"}
    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');
    ```
  </Accordion>

  <Accordion title="By creator — getAssetsByCreator">
    ```typescript theme={"system"}
    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');
    ```
  </Accordion>

  <Accordion title="By collection — getAssetsByGroup">
    ```typescript theme={"system"}
    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');
    ```
  </Accordion>

  <Accordion title="Transaction history — getSignaturesForAsset">
    ```typescript theme={"system"}
    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');
    ```
  </Accordion>
</AccordionGroup>

## 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.

<Accordion title="Get a Merkle proof — getAssetProof">
  ```typescript theme={"system"}
  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');
  ```
</Accordion>

## Praktik terbaik

* Gunakan [paginasi](/docs/id/das/pagination) 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

<CardGroup cols={3}>
  <Card title="Get SPL Tokens" icon="coins" href="/docs/id/das/get-tokens">
    Saldo, suplai, pemegang, dan harga token fungibel.
  </Card>

  <Card title="Search Assets" icon="magnifying-glass" href="/docs/id/das/search">
    Filter NFT berdasarkan koleksi, kreator, dan atribut.
  </Card>

  <Card title="DAS API FAQ" icon="book" href="/docs/id/faqs/das-api">
    Pertanyaan umum tentang aset, data harga, dan penggunaan.
  </Card>
</CardGroup>