> ## 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.
# getAsset
> Mengambil informasi mendetail untuk satu NFT Solana, NFT terkompresi, atau token, termasuk metadata, kepemilikan, data harga, dan atribut on-chain
## Penyimpanan Data Harga dalam Cache
Data harga yang ditampilkan oleh getAsset disimpan dalam cache dan mungkin bukan data terbaru. Informasi harga memiliki cache selama 600 detik, yang berarti data tersebut dapat berusia hingga 600 detik.
Data harga tersedia untuk 10 ribu token teratas berdasarkan volume 24 jam dan dapat ditemukan di bagian `token_info.price_info` dalam respons. Untuk aplikasi yang memerlukan harga secara real-time, pertimbangkan untuk menerapkan validasi tambahan.
## Agen MPL Core dan kelompok MIP-11
Jika tersedia, respons dapat menyertakan nilai `is_agent`, `agent_token`, `asset_signer`, dan `interface` seperti `MplCoreGroup`, serta objek `plugins.groups` untuk keanggotaan MIP-11. Bidang opsional yang sama ditampilkan oleh `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority`, dan `searchAssets`. Lihat [panduan pencarian aset](/docs/id/das/search) untuk filter `searchAssets`.
## Parameter Permintaan
Pengidentifikasi unik NFT Solana atau aset digital yang akan diambil. Biasanya, ini adalah alamat mint NFT atau token.
Opsi tampilan dan pemformatan untuk respons data aset.
Menampilkan informasi pengelompokan untuk koleksi yang belum diverifikasi alih-alih melewatinya.
Menampilkan metadata untuk koleksi.
Menampilkan token fungibel yang dimiliki oleh pemilik.
## OpenAPI
````yaml id/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: API Solana Digital Asset Standard (DAS)
version: 1.0.0
description: >
API Solana Digital Asset Standard (DAS) menyediakan akses yang komprehensif
dan terstandardisasi ke NFT dan aset digital pada blockchain Solana.
Rangkaian API yang canggih ini memungkinkan pengembang mengambil informasi
terperinci tentang aset digital apa pun di Solana,
termasuk NFT tradisional dan terkompresi, dengan format data yang konsisten
terlepas dari standar tokennya.
Perhatikan bahwa setiap respons DAS yang berhasil menyertakan bidang
`last_indexed_slot` yang menunjukkan slot terbaru yang dijamin telah
diindeks
secara lengkap oleh DAS. Semua data on-chain **hingga dan termasuk** slot
ini telah diindeks. Data setelah slot ini mungkin juga sudah diindeks,
meskipun tidak dijamin.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAsset
description: >
Ambil data komprehensif untuk NFT atau aset digital Solana apa pun
berdasarkan pengenal uniknya.
Endpoint ini menyediakan metadata on-chain dan off-chain lengkap, detail
kepemilikan, informasi royalti,
data koleksi, dan status kompresi untuk aset digital Solana apa pun.
Metode getAsset mendukung semua standar token,
termasuk NFT terkompresi (cNFT), NFT yang dapat diprogram (pNFT), dan
token SPL tradisional.
Gunakan endpoint ini untuk:
- Mengambil metadata lengkap untuk daftar di marketplace NFT
- Mengambil informasi kepemilikan aset untuk integrasi dompet
- Mengakses data royalti dan kreator untuk penerapan royalti
- Memeriksa status kompresi untuk mengidentifikasi NFT terkompresi yang
hemat biaya
- Melihat pengelompokan koleksi untuk analitik koleksi NFT
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: Versi protokol JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Pengenal unik untuk permintaan.
example: '1'
default: '1'
method:
type: string
description: Nama metode RPC yang akan dipanggil.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
Pengenal unik NFT atau aset digital Solana yang akan
diambil. Pengenal ini biasanya merupakan alamat mint NFT
atau token.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: Opsi tampilan dan pemformatan untuk respons data aset.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Menampilkan informasi pengelompokan untuk koleksi
yang belum diverifikasi alih-alih melewatinya.
showCollectionMetadata:
type: boolean
default: false
description: Menampilkan metadata koleksi.
showFungible:
type: boolean
description: >-
Menampilkan token fungibel yang dimiliki oleh
pemilik.
default: false
responses:
'200':
description: Respons berhasil
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Versi protokol JSON-RPC.
id:
type: string
description: ID yang digunakan untuk mengidentifikasi permintaan.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Semua data hingga dan termasuk slot ini dijamin telah
diindeks.
interface:
type: string
description: >-
Jenis antarmuka aset digital Solana yang menunjukkan
standar token dan implementasinya.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Menunjukkan apakah aset ini memiliki Identitas Agen.
Hanya bernilai true untuk aset MPL Core yang
menggunakan adaptor plugin eksternal AgentIdentity.
Nilai default-nya false dan dihilangkan dari respons
saat bernilai false.
agent_token:
type: string
description: >-
Alamat mint token agen yang dikodekan dengan Base58
dari program Agent Registry. Dihilangkan saat aset
tidak memiliki entri registri yang sesuai.
asset_signer:
type: string
description: >-
PDA berkode Base58 yang digunakan untuk menandatangani
atas nama aset; diturunkan secara deterministik dari
ID aset untuk aset MPL Core. Dihilangkan jika tidak
berlaku.
id:
type: string
description: Pengenal unik aset.
content:
type: object
description: >-
Informasi konten aset digital Solana, termasuk
metadata, file, dan tautan.
properties:
$schema:
type: string
description: URL skema untuk metadata aset.
json_uri:
type: string
description: >-
URI yang mengarah ke metadata JSON untuk NFT
Solana, biasanya dihosting di Arweave atau
penyimpanan terdesentralisasi lainnya.
files:
type: array
description: Array file yang terkait dengan aset.
items:
type: object
metadata:
type: object
description: >-
Informasi metadata lengkap tentang aset digital
Solana, termasuk nama, simbol, atribut, dan
standar token.
properties:
name:
type: string
description: Nama aset.
symbol:
type: string
description: Simbol aset.
attributes:
type: array
description: Array atribut karakteristik.
items:
type: object
properties:
value:
type: string
description: Nilai karakteristik.
trait_type:
type: string
description: Jenis karakteristik.
description:
type: string
description: Deskripsi aset.
token_standard:
type: string
description: Standar token yang digunakan.
links:
type: object
description: Tautan eksternal yang terkait dengan aset.
authorities:
type: array
description: Daftar otoritas yang terkait dengan aset.
items:
type: object
properties:
address:
type: string
description: Alamat otoritas.
scopes:
type: array
description: Cakupan otoritas.
items:
type: string
compression:
type: object
description: >-
Detail kompresi aset digital Solana yang menunjukkan
apakah aset tersebut merupakan NFT terkompresi dengan
validasi bukti status.
properties:
eligible:
type: boolean
description: >-
Menunjukkan apakah aset memenuhi syarat untuk
dikompresi.
compressed:
type: boolean
description: >-
Menunjukkan apakah aset saat ini dikompresi
menggunakan teknologi kompresi status Solana, yang
mengurangi biaya penyimpanan.
data_hash:
type: string
description: Hash data aset.
creator_hash:
type: string
description: Hash data kreator.
asset_hash:
type: string
description: Hash seluruh aset.
tree:
type: string
description: Alamat pohon Merkle.
seq:
type: integer
description: Nomor urut.
leaf_id:
type: integer
description: Pengenal daun dalam pohon Merkle.
grouping:
type: array
description: Informasi pengelompokan aset.
items:
type: object
properties:
group_key:
type: string
description: Kunci yang mengidentifikasi grup.
group_value:
type: string
description: Nilai yang terkait dengan grup.
royalty:
type: object
description: >-
Informasi royalti untuk aset digital Solana yang
digunakan dalam penghitungan biaya marketplace dan
pembayaran kreator.
properties:
royalty_model:
type: string
description: Model yang digunakan untuk royalti.
target:
type:
- string
- 'null'
description: Alamat tujuan royalti.
percent:
type: number
description: Persentase royalti.
basis_points:
type: integer
description: Basis poin royalti.
primary_sale_happened:
type: boolean
description: Menunjukkan apakah penjualan primer telah terjadi.
locked:
type: boolean
description: Menunjukkan apakah royalti dikunci.
creators:
type: array
description: Daftar kreator aset.
items:
type: object
properties:
address:
type: string
description: Alamat kreator.
share:
type: integer
description: Persentase bagian kreator.
verified:
type: boolean
description: Menunjukkan apakah kreator telah diverifikasi.
ownership:
type: object
description: >-
Detail kepemilikan aset digital Solana, termasuk
pemilik saat ini, status delegasi, dan informasi
pembekuan.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: Menunjukkan apakah aset dibekukan.
delegated:
type: boolean
description: Menunjukkan apakah aset didelegasikan.
delegate:
type:
- string
- 'null'
description: Alamat penerima delegasi jika aset didelegasikan.
ownership_model:
type: string
description: Model kepemilikan.
owner:
type: string
description: Alamat pemilik.
supply:
type:
- object
- 'null'
description: Informasi suplai aset.
properties:
print_max_supply:
type: integer
description: Suplai maksimum yang dapat dicetak.
print_current_supply:
type: integer
description: Suplai yang telah dicetak saat ini.
edition_nonce:
type: integer
description: Nonce edisi.
mutable:
type: boolean
description: Menunjukkan apakah aset dapat diubah.
burnt:
type: boolean
description: Menunjukkan apakah aset telah dibakar.
token_info:
type: object
description: Informasi khusus token.
properties:
supply:
type: integer
description: Total suplai token.
decimals:
type: integer
description: Jumlah angka desimal.
token_program:
type: string
description: ID program token.
mint_authority:
type: string
description: Alamat otoritas mint.
freeze_authority:
type: string
description: Alamat otoritas pembekuan.
plugins:
type: object
description: >-
Payload plugin MPL Core. Dapat menyertakan plugin
`groups` (MIP-11) pada aset dan koleksi.
additionalProperties: true
properties:
groups:
type: object
description: Plugin MIP-11 Groups dengan metadata keanggotaan.
properties:
authority:
type: object
description: Otoritas plugin (misalnya, UpdateAuthority).
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: >-
Keanggotaan grup untuk aset atau koleksi
ini.
items:
type: object
properties:
group_address:
type: string
description: Alamat Base58 akun grup MPL Core.
member_number:
type: integer
description: Nomor anggota dalam grup.
examples:
success:
value:
jsonrpc: '2.0'
id: test
result:
last_indexed_slot: 365749093
interface: ProgrammableNFT
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
content:
$schema: https://schema.metaplex.com/nft1.0.json
json_uri: >-
https://madlads.s3.us-west-2.amazonaws.com/json/8420.json
files:
- uri: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
mime: image/png
- uri: >-
https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
mime: image/png
metadata:
attributes:
- value: Male
trait_type: Gender
- value: King
trait_type: Type
- value: Royal
trait_type: Expression
- value: Mad Crown
trait_type: Hat
- value: Madness
trait_type: Eyes
- value: Mad Armor
trait_type: Clothing
- value: Royal Rug
trait_type: Background
description: Fock it.
name: 'Mad Lads #8420'
symbol: MAD
token_standard: ProgrammableNonFungible
links:
image: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
external_url: https://madlads.com
authorities:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
share: 100
verified: true
ownership:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue
supply:
print_max_supply: 0
print_current_supply: 0
edition_nonce: 254
mutable: true
burnt: false
token_info:
supply: 1
decimals: 0
token_program: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
mint_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
freeze_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
'400':
description: >-
Permintaan Tidak Valid. Server tidak dapat memahami permintaan
karena sintaks yang tidak valid.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32602
message:
type: string
example: Parameter permintaan tidak valid.
id:
type: string
example: '1'
'401':
description: >-
Tidak Diotorisasi. Klien harus mengautentikasi dirinya untuk
mendapatkan respons yang diminta.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: >-
Autentikasi gagal. Kunci API tidak ada atau tidak
valid.
id:
type: string
example: '1'
'403':
description: Dilarang. Klien tidak memiliki hak akses ke konten.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32003
message:
type: string
example: >-
Anda tidak memiliki izin untuk mengakses sumber daya
ini.
id:
type: string
example: '1'
'404':
description: >-
Tidak Ditemukan. Server tidak dapat menemukan sumber daya yang
diminta.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32004
message:
type: string
example: Aset yang diminta tidak ditemukan.
id:
type: string
example: '1'
'429':
description: >-
Terlalu Banyak Permintaan. Pengguna telah mengirim terlalu banyak
permintaan dalam jangka waktu tertentu.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32029
message:
type: string
example: Batas laju terlampaui. Silakan coba lagi nanti.
id:
type: string
example: '1'
'500':
description: >-
Kesalahan Internal Server. Server mengalami situasi yang tidak
diketahui cara penanganannya.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32000
message:
type: string
example: Terjadi kesalahan tak terduga pada server.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Kunci API Helius Anda. Anda bisa mendapatkannya secara gratis di
[dasbor](https://dashboard.helius.dev/api-keys).
````