> ## 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.
# getAssetsByAuthority
> Truy xuất tất cả NFT Solana, NFT nén và token do một địa chỉ thẩm quyền cụ thể kiểm soát, có hỗ trợ phân trang
## Tham số yêu cầu
Địa chỉ của chủ sở hữu có tài sản cần truy xuất.
Trang kết quả cần trả về.
Số lượng tài sản tối đa cần trả về.
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 tài sản được truy xuất.
* `created`
* `recent_action`
* `updated`
* `none`
Hướng sắp xếp các tài sản được truy xuất.
* `asc`
* `desc`
Con trỏ để phân trang ngược qua các tài sản.
Con trỏ để 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 xử lý chậm hơn.
## OpenAPI
````yaml vi/openapi/das-api/getAssetsByAuthority.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
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: getAssetsByAuthority
description: Trả về danh sách tài sản thuộc sở hữu của một thẩm quyền nhất định.
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 để nhận dạng yêu cầu.
default: '1'
method:
type: string
enum:
- getAssetsByAuthority
description: Tên của phương thức DAS cần gọi.
default: getAssetsByAuthority
params:
type: object
default:
authorityAddress: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
properties:
authorityAddress:
type: string
description: Địa chỉ của chủ sở hữu có tài sản cần truy xuất.
example: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
page:
type: integer
description: Trang kết quả cần trả về.
example: 1
limit:
type: integer
description: Số lượng tài sản tối đa cần trả về.
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 tài sản được truy xuất.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: Hướng sắp xếp các tài sản được truy xuất.
enum:
- asc
- desc
before:
type: string
description: Con trỏ để phân trang ngược qua các tài sản.
example: string
after:
type: string
description: Con trỏ để 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:
- authorityAddress
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: >-
Mọi dữ liệu cho đến và bao gồm cả slot này đều được
đảm bảo đã lập chỉ mục.
example: 365750752
total:
type: integer
description: Tổng số tài sản được tìm thấ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ột mảng tài sản.
items:
type: object
properties:
interface:
type: string
description: Giao diện của tài sản.
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ó Danh tính tác nhân
(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 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 của bên 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: ID của tài sản.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
content:
type: object
description: Nội dung của tài sản.
example:
$schema: https://schema.metaplex.com/nft1.0.json
json_uri: >-
https://madlads.s3.us-west-2.amazonaws.com/json/6867.json
files:
- uri: >-
https://madlads.s3.us-west-2.amazonaws.com/images/6867.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/6867.png
mime: image/png
authorities:
type: array
items:
type: object
description: Các thẩm quyền của tài sản.
example:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
type: object
description: Chi tiết nén của tài sản.
example:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
type: object
description: Chi tiết nhóm của tài sản.
example:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
type: object
description: Chi tiết tiền bản quyền của tài sản.
example:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
type: array
items:
type: object
description: Chi tiết về những người tạo ra tài sản.
example:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
ownership:
type: object
description: Chi tiết quyền sở hữu của tài sản.
example:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 3F21SJs4FMpsakrxmd8GjgfQZG6BN6MVsvXcm5Yc6Jcf
burnt: 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 thẩm quyền đã 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 một 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).
````