Skip to main content

Apa itu DAS API?

Digital Asset Standard (DAS) API adalah spesifikasi sumber terbuka yang menyediakan satu antarmuka terpadu untuk setiap jenis aset digital di Solana:
  • NFT reguler (Token yang Tidak Dapat Dipertukarkan)
  • NFT terkompresi (cNFT, menggunakan kompresi status)
  • Token yang dapat dipertukarkan (SPL Token dan Token-2022, termasuk ekstensi)
Satu rangkaian metode mencakup metadata, kepemilikan, saldo, koleksi, kreator, pencarian, dan bukti Merkle — sehingga Anda dapat membangun marketplace NFT, dompet, pelacak portofolio, aplikasi dengan akses berbasis token, dan alat analitik menggunakan API yang sama. Kedua jaringan menggunakan metode yang sama:
  • Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

Mengapa menggunakan Helius untuk DAS API?

All asset types, one API

NFT, NFT terkompresi, dan token yang dapat dipertukarkan (SPL dan Token-2022) melalui satu antarmuka.

Complete metadata

Data on-chain dan off-chain (Arweave, IPFS) diindeks dan dikembalikan bersama dalam satu panggilan.

Price data included

Informasi harga dalam USD untuk token terverifikasi, dikembalikan bersama saldo.

Search and filtering

Buat kueri berdasarkan pemilik, koleksi, kreator, otoritas, atau filter atribut terperinci.

Metode mana yang sebaiknya digunakan?

Sebagian besar integrasi dimulai dengan salah satu dari tiga metode. Gunakan tabel ini untuk memilih titik masuk yang tepat, lalu gunakan metode khusus di bawah ini. Sebagai pedoman umum:
  • Mengetahui ID aset yang tepat? Gunakan getAsset (atau getAssetBatch untuk banyak aset).
  • Ingin menampilkan aset milik sebuah dompet? Gunakan getAssetsByOwner.
  • Ingin memfilter berdasarkan koleksi, jenis token, atau atribut? Gunakan searchAssets.

Metode utama

Aset tunggal

getAsset

Data lengkap untuk satu aset berdasarkan ID-nya.

getAssetBatch

Hingga 1.000 aset dalam satu permintaan.

Aset berdasarkan pemilik, koleksi, atau kreator

getAssetsByOwner

Semua aset yang dimiliki sebuah dompet, beserta metadata dan saldo.

getAssetsByGroup

Semua aset dalam sebuah koleksi (kunci grup collection).

getAssetsByCreator

Semua aset yang dicetak oleh kreator tertentu.

getAssetsByAuthority

Semua aset yang dikendalikan oleh otoritas tertentu.

Pencarian

searchAssets

Pemfilteran fleksibel berdasarkan pemilik, koleksi, tokenType, dan atribut.

Aset terkompresi dan bukti

getAssetProof

Bukti Merkle untuk aset terkompresi, yang diperlukan untuk operasi on-chain.

getAssetProofBatch

Bukti Merkle untuk beberapa aset terkompresi sekaligus.

getSignaturesForAsset

Riwayat tanda tangan transaksi untuk suatu aset.

getNftEditions

Semua edisi yang dicetak dari NFT master.

Akun token

getTokenAccounts

Akun token berdasarkan mint atau pemilik, beserta saldo.

Mulai

Get Assets (NFTs)

Ambil NFT dan barang koleksi digital: aset tunggal, berdasarkan pemilik, koleksi, bukti, dan edisi.

Get SPL Tokens

Buat kueri untuk token yang dapat dipertukarkan: saldo, suplai, pemegang, dan akun token.

Search Assets

Filter aset berdasarkan pemilik, koleksi, jenis token, dan atribut.

Pagination

Paginasi berbasis halaman dan keyset untuk kumpulan hasil berukuran besar.

Menggunakan jenis aset khusus

Token yang dapat dipertukarkan

Helius memperluas DAS API agar mencakup semua token, termasuk token SPL biasa (tanpa metadata) dan Token-2022 (beserta ekstensinya). Dukungan token yang dapat dipertukarkan tersedia melalui getAsset, getAssetsByOwner, dan searchAssets menggunakan parameter tokenType, sedangkan harga token terverifikasi dikembalikan dalam token_info.price_info. Untuk kueri saldo, suplai, pemegang, dan akun token, lihat panduan Mendapatkan Token SPL dan ekstensi token yang dapat dipertukarkan.

NFT terkompresi

NFT dengan kompresi status (cNFT) menggunakan metode yang sama seperti NFT reguler untuk operasi baca (getAsset, getAssetsByOwner, searchAssets), ditambah dua metode khusus kompresi:
  • getAssetProof mengembalikan bukti Merkle yang diperlukan untuk memverifikasi dan menjalankan operasi on-chain seperti transfer dan pembakaran.
  • getSignaturesForAsset mengembalikan riwayat transaksi untuk aset terkompresi.
Lihat panduan Mendapatkan Aset untuk contoh lengkap NFT terkompresi.

Data off-chain

Sebagian besar koleksi NFT menyimpan metadata tambahan (atribut, gambar) secara off-chain di Arweave atau IPFS. DAS API mengindeks data off-chain ini dan mengembalikannya bersama data on-chain dalam satu panggilan.
Helius tidak dapat mendeteksi perubahan data off-chain. Data off-chain hanya diperbarui setelah aset terlihat lagi secara on-chain (misalnya, ketika aset diubah). Untuk meminta pengindeksan ulang, hubungi dukungan Helius.

Praktik terbaik

Pagination

Mulai dari halaman 1 (bukan 0). Gunakan batas 100–1.000 dan terapkan paginasi untuk kumpulan data berukuran besar.

Error handling

Periksa kesalahan pada setiap respons dan coba lagi dengan backoff eksponensial.

Performance

Gunakan metode batch jika memungkinkan, simpan respons dalam cache, dan hindari merangkai beberapa panggilan jika satu panggilan sudah cukup.

Security

Jangan pernah mengekspos kunci API Anda dalam kode sisi klien. Proksikan permintaan melalui server dan tetapkan kebijakan CORS.

Langkah berikutnya

Get Assets (NFTs)

Ambil dan buat kueri untuk NFT serta barang koleksi digital.

DAS API reference

Skema permintaan dan respons lengkap untuk setiap metode DAS.

DAS API FAQ

Pertanyaan umum tentang aset, data harga, dan penggunaan.