> ## 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
> Truy xuất tất cả NFT Solana và NFT nén trong một bộ sưu tập hoặc nhóm cụ thể, với khóa nhóm linh hoạt và hỗ trợ phân trang
## Tham số yêu cầu
Loại phân loại nhóm Solana dùng để tìm kiếm (ví dụ: 'collection', 'community', 'creator', v.v.).
Địa chỉ bộ sưu tập Solana hoặc mã định danh nhóm dùng để truy xuất tất cả NFT khớp với giá trị này.
Số trang dùng để phân trang qua các kết quả của bộ sưu tập Solana.
Số lượng NFT Solana tối đa cần trả về cho mỗi yêu cầu từ bộ sưu tập này.
Các tùy chọn sắp xếp cho phản hồi.
Tiêu chí dùng để sắp xếp các NFT Solana được truy xuất trong bộ sưu tập.
* `created`
* `recent_action`
* `updated`
* `none`
Hướng sắp xếp các NFT Solana được truy xuất trong bộ sưu tập.
* `asc`
* `desc`
Con trỏ dùng để phân trang ngược qua các tài sản.
Con trỏ dùng để phân trang xuôi qua các tài sản.
Các tùy chọn hiển thị cho phản hồi.
Hiển thị thông tin nhóm cho các bộ sưu tập chưa được xác minh thay vì bỏ qua chúng.
Hiển thị siêu dữ liệu của bộ sưu tập.
Hiển thị tổng số tài sản khớp với truy vấn. Tùy chọn này sẽ khiến yêu cầu chậm hơn.
## OpenAPI
````yaml vi/openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
title: API khám phá bộ sưu tập NFT Solana
version: 1.0.0
description: >
API Digital Asset Standard (DAS) nâng cao của Solana để khám phá toàn bộ bộ
sưu tập NFT và các nhóm token
trên blockchain Solana. API duyệt bộ sưu tập chuyên biệt này cho phép ứng
dụng truy xuất tất cả
tài sản kỹ thuật số trong các bộ sưu tập, cộng đồng hoặc nhóm cụ thể với khả
năng lọc và sắp xếp
mạnh mẽ. Phù hợp cho các chợ NFT, ứng dụng danh mục đầu tư và nền tảng phân
tích cần
hiển thị toàn bộ bộ sưu tập với định dạng nhất quán cho cả NFT truyền thống
và NFT nén.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Điểm cuối RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Điểm cuối RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetsByGroup
description: >
Truy xuất tất cả tài sản kỹ thuật số Solana thuộc một bộ sưu tập hoặc
nhóm cụ thể.
API duyệt bộ sưu tập mạnh mẽ này trả về danh sách đầy đủ các NFT có
cùng
chỉ định nhóm (chẳng hạn như bộ sưu tập, cộng đồng hoặc nhóm khác), kèm
theo
siêu dữ liệu toàn diện và thông tin chi tiết về quyền sở hữu của từng
tài sản. Đây là API thiết yếu cho các chợ NFT khi hiển thị
bộ sưu tập, ứng dụng danh mục đầu tư khi hiển thị tài sản theo nhóm và
nền tảng phân tích khi theo dõi
các chỉ số trên toàn bộ bộ sưu tập trong hệ sinh thái Solana.
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Phiên bản của giao thức JSON-RPC.
default: '2.0'
id:
type: string
description: ID dùng để xác định yêu cầu.
default: '1'
method:
type: string
enum:
- getAssetsByGroup
description: Tên của phương thức DAS cần gọi.
default: getAssetsByGroup
params:
type: object
default:
groupKey: collection
groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
properties:
groupKey:
type: string
description: >-
Loại phân loại nhóm Solana dùng để tìm kiếm (ví dụ:
'collection', 'community', 'creator', v.v.).
example: collection
groupValue:
type: string
description: >-
Địa chỉ bộ sưu tập Solana hoặc mã định danh nhóm dùng để
truy xuất tất cả NFT khớp với tiêu chí.
example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
page:
type: integer
description: >-
Số trang dùng để phân trang qua các kết quả của bộ sưu
tập Solana.
example: 1
limit:
type: integer
description: >-
Số lượng NFT Solana tối đa trả về cho mỗi yêu cầu từ bộ
sưu tập này.
example: 100
sortBy:
type: object
description: Các tùy chọn sắp xếp cho phản hồi.
properties:
sortBy:
type: string
description: >-
Tiêu chí dùng để sắp xếp các NFT Solana được truy
xuất trong bộ sưu tập.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
Thứ tự dùng để sắp xếp các NFT Solana được truy xuất
trong bộ sưu tập.
enum:
- asc
- desc
before:
type: string
description: Con trỏ dùng để phân trang ngược qua các tài sản.
example: string
after:
type: string
description: Con trỏ dùng để phân trang xuôi qua các tài sản.
example: string
options:
type: object
description: Các tùy chọn hiển thị cho phản hồi.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Hiển thị thông tin nhóm cho các bộ sưu tập chưa được
xác minh thay vì bỏ qua chúng.
default: false
showCollectionMetadata:
type: boolean
description: Hiển thị siêu dữ liệu của bộ sưu tập.
default: false
showGrandTotal:
type: boolean
description: >-
Hiển thị tổng số tài sản khớp với truy vấn. Tùy chọn
này sẽ làm yêu cầu chậm hơn.
default: false
required:
- groupKey
- groupValue
responses:
'200':
description: Phản hồi thành công
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Tất cả dữ liệu đến và bao gồm slot này được đảm bảo đã
lập chỉ mục.
example: 365750752
total:
type: integer
description: >-
Tổng số NFT Solana được tìm thấy trong bộ sưu tập hoặc
nhóm này.
example: 1
limit:
type: integer
description: Số lượng tài sản tối đa được yêu cầu.
example: 1
page:
type: integer
description: Trang kết quả hiện tại.
example: 1
items:
type: array
description: Mảng các NFT Solana thuộc bộ sưu tập hoặc nhóm này.
items:
type: object
properties:
interface:
type: string
description: >-
Giao diện tiêu chuẩn token Solana của NFT trong
bộ sưu tập này.
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: >-
Cho biết tài sản này có Agent Identity (plugin
bên ngoài AgentIdentity của MPL Core) hay không.
Bị lược bỏ khi giá trị là false.
agent_token:
type: string
description: >-
Địa chỉ mint của token tác nhân được mã hóa
Base58 từ chương trình Agent Registry. Bị lược
bỏ khi chưa đăng ký.
asset_signer:
type: string
description: >-
PDA người ký tài sản được mã hóa Base58 cho MPL
Core. Bị lược bỏ khi không áp dụng.
plugins:
type: object
description: >-
Các plugin MPL Core, bao gồm tư cách thành viên
`groups` MIP-11 tùy chọn.
additionalProperties: true
id:
type: string
description: >-
Địa chỉ mint duy nhất của NFT Solana này trong
bộ sưu tập.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
authorities:
type: array
description: >-
Các địa chỉ có thẩm quyền cập nhật NFT Solana
này trong bộ sưu tập.
compression:
type: object
description: >-
Trạng thái nén của NFT Solana này, cho biết NFT
có sử dụng công nghệ nén trạng thái hay không.
grouping:
type: array
description: >-
Các mối liên kết bộ sưu tập và nhóm của NFT
Solana này.
royalty:
type: object
description: >-
Cấu hình tiền bản quyền cho NFT Solana này khi
được bán trên các chợ.
creators:
type: array
description: >-
Các địa chỉ người sáng tạo đã được xác minh liên
kết với NFT Solana này trong bộ sưu tập.
ownership:
type: object
description: >-
Thông tin chi tiết về quyền sở hữu hiện tại của
NFT Solana này trong bộ sưu tập.
supply:
type: object
description: >-
Thông tin nguồn cung của NFT Solana này nếu đây
là phiên bản gốc có các bản in.
mutable:
type: boolean
description: >-
Cho biết cơ quan có thẩm quyền có thể cập nhật
siêu dữ liệu của NFT Solana này hay không.
example: true
burnt:
type: boolean
description: Cho biết NFT Solana này đã bị đốt/hủy hay chưa.
example: false
'400':
description: >-
Yêu cầu không hợp lệ. Máy chủ không thể hiểu yêu cầu do cú pháp
không hợp lệ.
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: Tham số yêu cầu không hợp lệ.
id:
type: string
example: '1'
'401':
description: >-
Chưa được xác thực. Máy khách phải tự xác thực để nhận phản hồi được
yêu cầu.
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: >-
Xác thực không thành công. Khóa API bị thiếu hoặc
không hợp lệ.
id:
type: string
example: '1'
'403':
description: Bị cấm. Máy khách không có quyền truy cập nội dung.
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: Bạn không có quyền truy cập tài nguyên này.
id:
type: string
example: '1'
'404':
description: Không tìm thấy. Máy chủ không thể tìm thấy tài nguyên được yêu cầu.
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: Không tìm thấy tài sản nào cho nhóm đã chỉ định.
id:
type: string
example: '1'
'429':
description: >-
Quá nhiều yêu cầu. Người dùng đã gửi quá nhiều yêu cầu trong một
khoảng thời gian nhất định.
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: Đã vượt quá giới hạn tốc độ. Vui lòng thử lại sau.
id:
type: string
example: '1'
'500':
description: >-
Lỗi máy chủ nội bộ. Máy chủ gặp phải tình huống mà máy chủ không
biết cách xử lý.
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: Đã xảy ra lỗi không mong muốn trên máy chủ.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong [bảng điều
khiển](https://dashboard.helius.dev/api-keys).
````