> ## 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
> Truy xuất thông tin chi tiết về một Solana NFT, NFT nén hoặc token, bao gồm siêu dữ liệu, quyền sở hữu, dữ liệu giá và các thuộc tính trên chuỗi
## Lưu dữ liệu giá vào bộ nhớ đệm
Dữ liệu giá do getAsset trả về được lưu vào bộ nhớ đệm và có thể không phải là dữ liệu mới nhất. Thông tin giá có thời gian lưu trong bộ nhớ đệm là 600 giây, nghĩa là dữ liệu có thể cũ tới 600 giây.
Dữ liệu giá có sẵn cho 10k token hàng đầu theo khối lượng giao dịch trong 24 giờ và nằm trong phần `token_info.price_info` của phản hồi. Đối với các ứng dụng cần giá theo thời gian thực, hãy cân nhắc triển khai bước xác thực bổ sung.
## Tác nhân MPL Core và nhóm MIP-11
Khi có, phản hồi có thể bao gồm các giá trị `is_agent`, `agent_token`, `asset_signer`, `interface` như `MplCoreGroup` và một đối tượng `plugins.groups` cho tư cách thành viên MIP-11. Các trường tùy chọn tương tự được trả về bởi `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority` và `searchAssets`. Xem [hướng dẫn tìm kiếm tài sản](/docs/vi/das/search) để biết các bộ lọc `searchAssets`.
## Tham số yêu cầu
Mã định danh duy nhất của Solana NFT hoặc tài sản số cần truy xuất. Đây thường là địa chỉ mint của NFT hoặc token.
Các tùy chọn hiển thị và định dạng cho phản hồi dữ liệu tài sản.
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ị các token có thể thay thế do chủ sở hữu nắm giữ.
## OpenAPI
````yaml vi/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: API Tiêu chuẩn Tài sản Kỹ thuật số Solana (DAS)
version: 1.0.0
description: >
API Tiêu chuẩn Tài sản Kỹ thuật số Solana (DAS) cung cấp quyền truy cập toàn
diện và được chuẩn hóa vào các NFT và tài sản kỹ thuật số trên blockchain
Solana.
Bộ API mạnh mẽ này cho phép nhà phát triển truy xuất thông tin chi tiết về
bất kỳ tài sản kỹ thuật số nào trên Solana,
bao gồm cả NFT truyền thống và NFT nén, với định dạng dữ liệu nhất quán bất
kể tiêu chuẩn token.
Lưu ý rằng mọi phản hồi DAS thành công đều bao gồm trường
`last_indexed_slot`, cho biết slot gần nhất mà DAS đảm bảo đã lập chỉ mục
đầy đủ. Tất cả dữ liệu trên chuỗi **tính đến và bao gồm** slot này đã được
lập chỉ mục. Dữ liệu sau slot này cũng có thể đã được lập chỉ mục,
nhưng không được đảm bảo.
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: getAsset
description: >
Truy xuất dữ liệu toàn diện về bất kỳ NFT hoặc tài sản kỹ thuật số
Solana nào bằng mã định danh duy nhất của tài sản đó.
Điểm cuối này cung cấp đầy đủ siêu dữ liệu trên chuỗi và ngoài chuỗi,
thông tin chi tiết về quyền sở hữu, thông tin tiền bản quyền,
dữ liệu bộ sưu tập và trạng thái nén của bất kỳ tài sản kỹ thuật số
Solana nào. Phương thức getAsset hỗ trợ tất cả tiêu chuẩn token,
bao gồm NFT nén (cNFT), NFT có thể lập trình (pNFT) và token SPL truyền
thống.
Sử dụng điểm cuối này để:
- Tìm nạp siêu dữ liệu đầy đủ cho danh sách trên sàn giao dịch NFT
- Truy xuất thông tin quyền sở hữu tài sản để tích hợp ví
- Truy cập dữ liệu tiền bản quyền và người sáng tạo để thực thi tiền bản
quyền
- Kiểm tra trạng thái nén để xác định các NFT nén tiết kiệm chi phí
- Xem cách nhóm bộ sưu tập để phân tích bộ sưu tập NFT
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: Phiên bản giao thức JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Mã định danh duy nhất cho yêu cầu.
example: '1'
default: '1'
method:
type: string
description: Tên của phương thức RPC cần gọi.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
Mã định danh duy nhất của NFT hoặc tài sản kỹ thuật số
Solana cần truy xuất. Đây thường là địa chỉ đúc của NFT
hoặc token.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: >-
Các tùy chọn hiển thị và định dạng cho phản hồi dữ liệu
tài sản.
properties:
showUnverifiedCollections:
type: boolean
default: false
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.
showCollectionMetadata:
type: boolean
default: false
description: Hiển thị siêu dữ liệu của bộ sưu tập.
showFungible:
type: boolean
description: >-
Hiển thị các token có thể thay thế do chủ sở hữu nắm
giữ.
default: false
responses:
'200':
description: Phản hồi thành công
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Phiên bản của giao thức JSON-RPC.
id:
type: string
description: ID dùng để xác định yêu cầu.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Tất cả dữ liệu tính đến và bao gồm slot này được đảm
bảo đã được lập chỉ mục.
interface:
type: string
description: >-
Loại giao diện của tài sản kỹ thuật số Solana, cho
biết tiêu chuẩn token và cách triển khai 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
is_agent:
type: boolean
description: >-
Tài sản này có Danh tính Tác nhân hay không. Chỉ có
giá trị true đối với tài sản MPL Core sử dụng bộ điều
hợp plugin bên ngoài AgentIdentity. Giá trị mặc định
là false và bị lược khỏi phản hồi khi là false.
agent_token:
type: string
description: >-
Địa chỉ đúc được mã hóa Base58 của token tác nhân từ
chương trình Agent Registry. Bị lược bỏ khi tài sản
không có mục đăng ký tương ứng.
asset_signer:
type: string
description: >-
PDA được mã hóa Base58 dùng để ký thay mặt tài sản;
được dẫn xuất theo cách xác định từ ID tài sản đối với
tài sản MPL Core. Bị lược bỏ khi không áp dụng.
id:
type: string
description: Mã định danh duy nhất của tài sản.
content:
type: object
description: >-
Thông tin nội dung của tài sản kỹ thuật số Solana, bao
gồm siêu dữ liệu, tệp và liên kết.
properties:
$schema:
type: string
description: URL lược đồ cho siêu dữ liệu tài sản.
json_uri:
type: string
description: >-
URI trỏ đến siêu dữ liệu JSON của NFT Solana,
thường được lưu trữ trên Arweave hoặc nền tảng lưu
trữ phi tập trung khác.
files:
type: array
description: Mảng các tệp được liên kết với tài sản.
items:
type: object
metadata:
type: object
description: >-
Thông tin siêu dữ liệu đầy đủ về tài sản kỹ thuật
số Solana, bao gồm tên, ký hiệu, thuộc tính và
tiêu chuẩn token.
properties:
name:
type: string
description: Tên của tài sản.
symbol:
type: string
description: Ký hiệu của tài sản.
attributes:
type: array
description: Mảng các thuộc tính đặc điểm.
items:
type: object
properties:
value:
type: string
description: Giá trị của đặc điểm.
trait_type:
type: string
description: Loại đặc điểm.
description:
type: string
description: Mô tả tài sản.
token_standard:
type: string
description: Tiêu chuẩn token được sử dụng.
links:
type: object
description: Các liên kết bên ngoài liên quan đến tài sản.
authorities:
type: array
description: Danh sách các thẩm quyền liên kết với tài sản.
items:
type: object
properties:
address:
type: string
description: Địa chỉ của thẩm quyền.
scopes:
type: array
description: Phạm vi của thẩm quyền.
items:
type: string
compression:
type: object
description: >-
Chi tiết nén của tài sản kỹ thuật số Solana, cho biết
tài sản có phải là NFT nén với quy trình xác thực bằng
bằng chứng trạng thái hay không.
properties:
eligible:
type: boolean
description: Tài sản có đủ điều kiện để nén hay không.
compressed:
type: boolean
description: >-
Tài sản hiện có được nén bằng công nghệ nén trạng
thái của Solana để giảm chi phí lưu trữ hay không.
data_hash:
type: string
description: Giá trị băm của dữ liệu tài sản.
creator_hash:
type: string
description: Giá trị băm của dữ liệu người sáng tạo.
asset_hash:
type: string
description: Giá trị băm của toàn bộ tài sản.
tree:
type: string
description: Địa chỉ cây Merkle.
seq:
type: integer
description: Số thứ tự.
leaf_id:
type: integer
description: Mã định danh nút lá trong cây Merkle.
grouping:
type: array
description: Thông tin nhóm của tài sản.
items:
type: object
properties:
group_key:
type: string
description: Khóa xác định nhóm.
group_value:
type: string
description: Giá trị liên kết với nhóm.
royalty:
type: object
description: >-
Thông tin tiền bản quyền của tài sản kỹ thuật số
Solana, dùng để tính phí trên sàn giao dịch và thanh
toán cho người sáng tạo.
properties:
royalty_model:
type: string
description: Mô hình được sử dụng cho tiền bản quyền.
target:
type:
- string
- 'null'
description: Địa chỉ đích nhận tiền bản quyền.
percent:
type: number
description: Tỷ lệ phần trăm tiền bản quyền.
basis_points:
type: integer
description: Điểm cơ bản của tiền bản quyền.
primary_sale_happened:
type: boolean
description: Đợt bán sơ cấp đã diễn ra hay chưa.
locked:
type: boolean
description: Tiền bản quyền có bị khóa hay không.
creators:
type: array
description: Danh sách những người sáng tạo tài sản.
items:
type: object
properties:
address:
type: string
description: Địa chỉ của người sáng tạo.
share:
type: integer
description: Tỷ lệ phần trăm của người sáng tạo.
verified:
type: boolean
description: Người sáng tạo đã được xác minh hay chưa.
ownership:
type: object
description: >-
Chi tiết quyền sở hữu tài sản kỹ thuật số Solana, bao
gồm chủ sở hữu hiện tại, trạng thái ủy quyền và thông
tin đóng băng.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: Tài sản có bị đóng băng hay không.
delegated:
type: boolean
description: Tài sản có được ủy quyền hay không.
delegate:
type:
- string
- 'null'
description: >-
Địa chỉ của bên được ủy quyền nếu tài sản được ủy
quyền.
ownership_model:
type: string
description: Mô hình quyền sở hữu.
owner:
type: string
description: Địa chỉ của chủ sở hữu.
supply:
type:
- object
- 'null'
description: Thông tin nguồn cung của tài sản.
properties:
print_max_supply:
type: integer
description: Nguồn cung tối đa có thể in.
print_current_supply:
type: integer
description: Nguồn cung đã in hiện tại.
edition_nonce:
type: integer
description: Nonce phiên bản.
mutable:
type: boolean
description: Tài sản có thể thay đổi hay không.
burnt:
type: boolean
description: Tài sản đã bị đốt hay chưa.
token_info:
type: object
description: Thông tin dành riêng cho token.
properties:
supply:
type: integer
description: Tổng nguồn cung token.
decimals:
type: integer
description: Số chữ số thập phân.
token_program:
type: string
description: ID chương trình token.
mint_authority:
type: string
description: Địa chỉ thẩm quyền đúc.
freeze_authority:
type: string
description: Địa chỉ thẩm quyền đóng băng.
plugins:
type: object
description: >-
Payload plugin MPL Core. Có thể bao gồm plugin
`groups` (MIP-11) trên tài sản và bộ sưu tập.
additionalProperties: true
properties:
groups:
type: object
description: Plugin Groups MIP-11 với siêu dữ liệu thành viên.
properties:
authority:
type: object
description: 'Thẩm quyền plugin (ví dụ: UpdateAuthority).'
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: >-
Tư cách thành viên nhóm của tài sản hoặc
bộ sưu tập này.
items:
type: object
properties:
group_address:
type: string
description: >-
Địa chỉ Base58 của tài khoản nhóm MPL
Core.
member_number:
type: integer
description: Số thành viên trong nhóm.
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: >-
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 được yêu cầu.
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).
````