> ## 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.
# searchAssets
> Cari dan filter NFT Solana, NFT terkompresi, dan token menggunakan kriteria fleksibel, termasuk kepemilikan, kreator, koleksi, dan atribut khusus
## Parameter Permintaan
Alamat dompet Solana yang aset digital miliknya akan diambil untuk memfilter hasil pencarian.
Filter untuk jenis token Solana tertentu, termasuk NFT terkompresi (cNFT), NFT reguler,
NFT yang dapat diprogram (pNFT), atau token SPL fungibel untuk pencarian aset yang ditargetkan.
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
Halaman hasil yang akan dikembalikan.
Kriteria alamat otoritas untuk memfilter aset digital Solana berdasarkan otoritas program,
yang berguna untuk menemukan aset yang dikendalikan oleh protokol atau otoritas pembaruan tertentu.
Jumlah maksimum aset yang akan dikembalikan.
Opsi pengurutan untuk respons.
Kriteria yang digunakan untuk mengurutkan aset.
* `created`
* `recent_action`
* `updated`
* `none`
Arah pengurutan.
* `asc`
* `desc`
Filter untuk NFT Solana terkompresi (cNFT) yang menggunakan teknologi kompresi status
untuk mengurangi biaya penyimpanan dan meningkatkan skalabilitas.
Filter untuk aset Solana yang memenuhi syarat untuk dikompresi tetapi belum
dikompresi ke dalam format kompresi status.
Kriteria delegasi untuk pencarian aset.
Kriteria alamat dompet kreator untuk menemukan NFT Solana yang dibuat oleh seniman,
proyek, atau kreator tertentu guna melacak atribusi dan royalti.
Menentukan apakah kreator telah diverifikasi.
Larik pengelompokan koleksi untuk memfilter NFT Solana berdasarkan keanggotaannya dalam koleksi
(misalnya, \["collection", "\"]) guna menemukan aset terkait.
Alamat pohon Merkle untuk memfilter NFT terkompresi (cNFT) berdasarkan pohon koleksinya.
Parameter ini khusus untuk Helius dan bukan bagian dari spesifikasi resmi DAS.
Kriteria suplai untuk pencarian aset.
Kriteria mint suplai untuk pencarian aset.
Menentukan apakah aset dibekukan.
Menentukan apakah aset dibakar.
Filter aset yang memiliki Identitas Agen (plugin eksternal MPL Core AgentIdentity).
Filter berdasarkan alamat mint token agen base58 dari program Agent Registry.
Filter berdasarkan PDA penanda tangan aset base58 (MPL Core).
Jenis antarmuka standar token Solana untuk memfilter implementasi NFT tertentu,
termasuk NFT yang dapat diprogram, NFT lama, token fungibel, serta aset, koleksi, atau grup MPL Core (MIP-11).
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
Kriteria jenis target royalti.
Kriteria target royalti.
Kriteria jumlah royalti.
Kriteria model kepemilikan.
Kursor untuk melakukan paginasi mundur.
Kursor untuk melakukan paginasi maju.
Opsi tampilan lanjutan untuk menyesuaikan respons pencarian aset Solana.
Tampilkan koleksi yang belum diverifikasi alih-alih melewatinya.
Tampilkan metadata untuk koleksi.
Tampilkan jumlah total aset yang cocok (permintaan lebih lambat).
Tampilkan saldo native (SOL) milik pemilik.
Tampilkan aset dengan saldo nol.
## OpenAPI
````yaml id/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: API Penemuan & Pencarian NFT Solana
version: 1.0.0
description: >
API Digital Asset Standard (DAS) Solana tingkat lanjut untuk mencari dan
menemukan NFT, token, serta aset digital lainnya di seluruh ekosistem Solana
dengan kemampuan pemfilteran yang canggih.
API pencarian komprehensif ini menyediakan fondasi bagi marketplace NFT,
aplikasi portofolio, dan platform analitik
untuk menemukan dan memfilter aset digital berdasarkan berbagai kriteria,
termasuk koleksi, kreator, status kompresi,
dan kepemilikan—dengan dukungan untuk NFT tradisional dan terkompresi di
seluruh ekosistem Solana.
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: searchAssets
description: >
Cari dan temukan aset digital Solana dengan opsi pemfilteran yang
komprehensif.
API penemuan yang canggih ini memungkinkan aplikasi menemukan NFT, NFT
terkompresi, token fungibel,
dan aset digital lainnya menggunakan berbagai kriteria, termasuk
kepemilikan, kreator, koleksi,
status kompresi, dan atribut metadata. Cocok untuk marketplace, pelacak
portofolio, dan platform analitik yang memerlukan kemampuan penemuan
aset tingkat lanjut
di seluruh ekosistem Solana.
Kemampuan utama:
- Pencarian multikriteria di seluruh standar NFT Solana (tradisional,
terkompresi, dapat diprogram)
- Pemfilteran berbasis koleksi untuk proyek dan komunitas NFT
- Kueri berbasis kreator dan kepemilikan untuk atribusi dan analisis
portofolio
- Pemfilteran status kompresi untuk mengidentifikasi aset yang hemat
biaya
- Pencarian atribut metadata untuk penemuan berbasis karakteristik
- Dukungan paginasi lengkap untuk kumpulan hasil berukuran besar
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Versi protokol JSON-RPC.
default: '2.0'
id:
type: string
description: ID untuk mengidentifikasi permintaan.
default: '1'
method:
type: string
enum:
- searchAssets
description: Nama metode JSON-RPC yang akan dipanggil.
default: searchAssets
params:
type: object
description: Parameter untuk metode `searchAssets`.
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: >-
Alamat dompet Solana untuk mengambil aset digital yang
dimiliki guna memfilter hasil pencarian.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >
Filter untuk jenis token Solana tertentu, termasuk NFT
terkompresi (cNFT), NFT reguler,
NFT yang dapat diprogram (pNFT), atau token SPL fungibel
untuk penemuan aset yang ditargetkan.
example: all
page:
type: integer
description: Halaman hasil yang akan dikembalikan.
example: 1
authorityAddress:
type: string
description: >
Kriteria alamat otoritas untuk memfilter aset digital
Solana berdasarkan otoritas program,
berguna untuk menemukan aset yang dikendalikan oleh
protokol atau otoritas pembaruan tertentu.
example: string
limit:
type: integer
description: Jumlah maksimum aset yang akan dikembalikan.
example: 100
sortBy:
type: object
description: Opsi pengurutan untuk respons.
properties:
sortBy:
type: string
description: Kriteria yang digunakan untuk mengurutkan aset.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: Arah pengurutan.
enum:
- asc
- desc
compressed:
type: boolean
description: >
Filter untuk NFT Solana terkompresi (cNFT) yang
menggunakan teknologi kompresi status
untuk mengurangi biaya penyimpanan dan meningkatkan
skalabilitas.
example: true
compressible:
type: boolean
description: >
Filter untuk aset Solana yang memenuhi syarat untuk
dikompresi, tetapi belum
dikompresi ke dalam format kompresi status.
example: false
delegate:
type: integer
description: Kriteria delegasi untuk pencarian aset.
creatorAddress:
type: string
description: >
Kriteria alamat dompet kreator untuk menemukan NFT
Solana yang dibuat oleh artis,
proyek, atau kreator tertentu guna melacak atribusi dan
royalti.
example: string
creatorVerified:
type: boolean
description: Menunjukkan apakah kreator telah diverifikasi.
example: true
grouping:
type: array
items:
type: string
description: >
Array pengelompokan koleksi untuk memfilter NFT Solana
berdasarkan keanggotaan koleksinya
(misalnya ["collection", ""]) guna
menemukan aset terkait.
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: >
Alamat pohon Merkle untuk memfilter NFT terkompresi
(cNFT) berdasarkan pohon koleksinya.
Parameter ini khusus untuk Helius dan bukan bagian dari
spesifikasi resmi DAS.
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: Kriteria pasokan untuk pencarian aset.
example: 0
supplyMint:
type: string
description: Kriteria mint pasokan untuk pencarian aset.
frozen:
type: boolean
description: Menunjukkan apakah aset dibekukan.
example: false
burnt:
type: boolean
description: Menunjukkan apakah aset telah dibakar.
example: false
isAgent:
type: boolean
description: >-
Filter aset yang memiliki Identitas Agen (plugin
eksternal MPL Core AgentIdentity).
agentToken:
type: string
description: >-
Filter berdasarkan alamat mint token agen base58 dari
program Agent Registry.
assetSigner:
type: string
description: >-
Filter berdasarkan PDA penanda tangan aset base58 (MPL
Core).
interface:
type: string
description: >
Jenis antarmuka standar token Solana untuk memfilter
implementasi NFT tertentu,
termasuk NFT yang dapat diprogram, NFT lama, token
fungibel, serta aset, koleksi, atau grup MPL Core
(MIP-11).
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: Custom
royaltyTargetType:
type: string
description: Kriteria jenis target royalti.
example: creators
royaltyTarget:
type: integer
description: Kriteria target royalti.
example: 0
royaltyAmount:
type: integer
description: Kriteria jumlah royalti.
example: 0
ownerType:
type: integer
description: Kriteria model kepemilikan.
example: 1
before:
type: string
description: Kursor untuk paginasi mundur.
example: string
after:
type: string
description: Kursor untuk paginasi maju.
example: string
options:
type: object
description: >-
Opsi tampilan tingkat lanjut untuk menyesuaikan respons
pencarian aset Solana.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Tampilkan koleksi yang belum diverifikasi alih-alih
melewatinya.
showCollectionMetadata:
type: boolean
default: false
description: Tampilkan metadata koleksi.
showGrandTotal:
type: boolean
default: false
description: >-
Tampilkan jumlah total aset yang cocok (permintaan
lebih lambat).
showNativeBalance:
type: boolean
default: false
description: Tampilkan saldo native (SOL) milik pemilik.
showZeroBalance:
type: boolean
default: false
description: Tampilkan aset dengan saldo nol.
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: Respons berhasil
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Semua data hingga dan termasuk slot ini dijamin telah
diindeks.
example: 365750752
total:
type: integer
description: >-
Jumlah total NFT dan aset digital Solana yang cocok
dengan kriteria pencarian.
example: 80
limit:
type: integer
description: Jumlah maksimum aset yang diminta.
example: 50
page:
type: integer
description: Halaman hasil saat ini.
example: 1
items:
type: array
description: Array aset.
items:
type: object
properties:
interface:
type: string
description: >-
Jenis implementasi standar token Solana dari
aset digital.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Menunjukkan apakah aset ini memiliki Identitas
Agen (plugin eksternal MPL Core AgentIdentity).
Dihilangkan jika bernilai false.
agent_token:
type: string
description: >-
Mint token agen yang dikodekan dengan base58
dari program Agent Registry. Dihilangkan jika
tidak terdaftar.
asset_signer:
type: string
description: >-
PDA penanda tangan aset yang dikodekan dengan
base58 untuk MPL Core. Dihilangkan jika tidak
berlaku.
plugins:
type: object
description: >-
Plugin MPL Core, termasuk keanggotaan `groups`
MIP-11 opsional.
additionalProperties: true
id:
type: string
description: >-
Pengidentifikasi alamat mint unik dari aset
digital Solana.
ownership:
type: object
description: >-
Detail kepemilikan aset digital Solana, termasuk
pemilik dan model saat ini.
content:
type: object
description: >-
Konten dan metadata aset digital Solana,
termasuk URI, atribut, dan media.
example:
total: 80
limit: 50
page: 1
items:
- interface: V1_NFT
id: SomeNftMintKey12345
ownership:
owner: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
ownership_model: single
content:
json_uri: https://example.com/metadata/12345.json
nativeBalance:
type: object
description: >-
Saldo native SOL dari akun dompet Solana dalam lamport dan
nilai USD.
properties:
lamports:
type: integer
description: Jumlah lamport dalam akun.
price_per_sol:
type: number
description: Harga SOL saat ini.
total_price:
type: number
description: Total nilai SOL dalam akun ini.
'400':
description: >-
Permintaan Tidak Valid. Server tidak dapat memahami permintaan
karena sintaks 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 Terotorisasi. Klien harus mengautentikasi diri 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: >-
Tidak ditemukan aset yang cocok dengan kriteria
pencarian.
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 Server Internal. Server mengalami situasi yang tidak dapat
ditanganinya.
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 dapat memperolehnya secara gratis di
[dasbor](https://dashboard.helius.dev/api-keys).
````