> ## 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.
# getAssetsByGroup
> Ambil semua NFT Solana dan NFT terkompresi dalam koleksi atau grup tertentu dengan kunci pengelompokan yang fleksibel dan dukungan paginasi
## Parameter Permintaan
Jenis klasifikasi grup Solana yang akan digunakan untuk pencarian (misalnya, 'collection', 'community', 'creator', dan sebagainya).
Alamat koleksi atau pengidentifikasi grup Solana yang digunakan untuk mengambil semua NFT yang cocok.
Nomor halaman untuk menelusuri hasil koleksi Solana dengan paginasi.
Jumlah maksimum NFT Solana dari koleksi ini yang akan ditampilkan per permintaan.
Opsi pengurutan untuk respons.
Kriteria yang digunakan untuk mengurutkan NFT Solana yang diambil dari koleksi.
* `created`
* `recent_action`
* `updated`
* `none`
Arah pengurutan NFT Solana yang diambil dari koleksi.
* `asc`
* `desc`
Kursor untuk menelusuri aset ke belakang dengan paginasi.
Kursor untuk menelusuri aset ke depan dengan paginasi.
Opsi tampilan untuk respons.
Menampilkan informasi pengelompokan untuk koleksi yang belum diverifikasi alih-alih melewatkannya.
Menampilkan metadata untuk koleksi.
Menampilkan jumlah total aset yang cocok dengan kueri. Opsi ini akan memperlambat permintaan.
## OpenAPI
````yaml id/openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
title: API Penjelajah Koleksi NFT Solana
version: 1.0.0
description: >
API Digital Asset Standard (DAS) Solana tingkat lanjut untuk menjelajahi
koleksi NFT dan grup token secara lengkap
di blockchain Solana. API penelusuran koleksi khusus ini memungkinkan
aplikasi mengambil semua
aset digital dalam koleksi, komunitas, atau pengelompokan tertentu dengan
kemampuan pemfilteran dan pengurutan
yang canggih. Cocok untuk marketplace NFT, aplikasi portofolio, dan platform
analitik yang perlu
menampilkan koleksi lengkap dengan format yang konsisten untuk NFT
tradisional maupun terkompresi.
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: getAssetsByGroup
description: >
Mengambil semua aset digital Solana yang termasuk dalam koleksi atau
pengelompokan tertentu.
API penelusuran koleksi yang canggih ini menampilkan daftar lengkap NFT
yang memiliki
penetapan grup yang sama (seperti koleksi, komunitas, atau pengelompokan
lainnya), beserta
metadata dan detail kepemilikan lengkap untuk setiap aset. Sangat
penting bagi marketplace NFT yang menampilkan
koleksi, aplikasi portofolio yang menampilkan aset yang dikelompokkan,
dan platform analitik yang melacak
metrik seluruh koleksi di seluruh ekosistem Solana.
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:
- getAssetsByGroup
description: Nama metode DAS yang akan dipanggil.
default: getAssetsByGroup
params:
type: object
default:
groupKey: collection
groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
properties:
groupKey:
type: string
description: >-
Jenis klasifikasi grup Solana yang digunakan untuk
pencarian (misalnya, 'collection', 'community',
'creator', dan sebagainya).
example: collection
groupValue:
type: string
description: >-
Alamat koleksi atau pengidentifikasi grup Solana yang
digunakan untuk mengambil semua NFT yang cocok.
example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
page:
type: integer
description: >-
Nomor halaman untuk melakukan paginasi pada hasil
koleksi Solana.
example: 1
limit:
type: integer
description: >-
Jumlah maksimum NFT Solana dari koleksi ini yang akan
ditampilkan per permintaan.
example: 100
sortBy:
type: object
description: Opsi pengurutan untuk respons.
properties:
sortBy:
type: string
description: >-
Kriteria yang digunakan untuk mengurutkan NFT Solana
yang diambil dari koleksi.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
Arah pengurutan NFT Solana yang diambil dari
koleksi.
enum:
- asc
- desc
before:
type: string
description: Kursor untuk melakukan paginasi mundur pada aset.
example: string
after:
type: string
description: Kursor untuk melakukan paginasi maju pada aset.
example: string
options:
type: object
description: Opsi tampilan untuk respons.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Menampilkan informasi pengelompokan untuk koleksi
yang belum diverifikasi alih-alih melewatinya.
default: false
showCollectionMetadata:
type: boolean
description: Menampilkan metadata koleksi.
default: false
showGrandTotal:
type: boolean
description: >-
Menampilkan jumlah total aset yang cocok dengan
kueri. Opsi ini akan memperlambat permintaan.
default: false
required:
- groupKey
- groupValue
responses:
'200':
description: Respons berhasil
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
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 Solana yang ditemukan dalam koleksi
atau grup ini.
example: 1
limit:
type: integer
description: Jumlah maksimum aset yang diminta.
example: 1
page:
type: integer
description: Halaman hasil saat ini.
example: 1
items:
type: array
description: >-
Array NFT Solana yang termasuk dalam koleksi atau grup
ini.
items:
type: object
properties:
interface:
type: string
description: >-
Antarmuka standar token Solana dari NFT dalam
koleksi ini.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: ProgrammableNFT
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 berkode Base58 dari program
Agent Registry. Dihilangkan jika tidak
terdaftar.
asset_signer:
type: string
description: >-
PDA penanda tangan aset berkode 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: Alamat mint unik NFT Solana ini dalam koleksi.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
authorities:
type: array
description: >-
Otoritas pembaruan untuk NFT Solana ini dalam
koleksi.
compression:
type: object
description: >-
Status kompresi NFT Solana ini, yang menunjukkan
apakah NFT tersebut menggunakan teknologi
kompresi status.
grouping:
type: array
description: >-
Asosiasi koleksi dan pengelompokan untuk NFT
Solana ini.
royalty:
type: object
description: >-
Konfigurasi royalti untuk NFT Solana ini ketika
dijual di marketplace.
creators:
type: array
description: >-
Alamat kreator terverifikasi yang terkait dengan
NFT Solana ini dalam koleksi.
ownership:
type: object
description: >-
Detail kepemilikan saat ini untuk NFT Solana ini
dalam koleksi.
supply:
type: object
description: >-
Informasi suplai untuk NFT Solana ini jika
merupakan edisi utama dengan cetakan.
mutable:
type: boolean
description: >-
Menunjukkan apakah metadata NFT Solana ini dapat
diperbarui oleh otoritas.
example: true
burnt:
type: boolean
description: >-
Menunjukkan apakah NFT Solana ini telah
dibakar/dimusnahkan.
example: false
'400':
description: >-
Permintaan Buruk. Server tidak dapat memahami permintaan karena
sintaksis 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: >-
Tidak ada aset yang ditemukan untuk grup yang
ditentukan.
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).
````