> ## 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.
# getAssetBatch
> Truy xuất thông tin chi tiết cho tối đa 1.000 NFT Solana, NFT nén hoặc token trong một yêu cầu theo lô hiệu quả
## Tham số yêu cầu
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ị các token có thể thay thế do chủ sở hữu nắm giữ.
## OpenAPI
````yaml vi/openapi/das-api/getAssetBatch.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: getAssetBatch
description: Trả về một lô tài sản dựa trên ID của chúng.
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
example: '1'
description: ID dùng để xác định yêu cầu.
default: '1'
method:
type: string
enum:
- getAssetBatch
description: Tên của phương thức DAS cần gọi.
default: getAssetBatch
params:
type: object
default:
ids:
- F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
ids:
type: array
items:
type: string
description: ID của tài sản cần truy xuất.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: Các tùy chọn hiển thị cho phản hồi.
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
required:
- ids
example:
ids:
- F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
responses:
'200':
description: Phản hồi thành công
content:
application/json:
schema:
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 ký tài sản được mã hóa Base58 cho MPL Core. Bị lược
bỏ khi không áp dụng.
id:
type: string
description: ID của tài sản.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
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
content:
type: object
description: Nội dung của tài sản.
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 đã lập chỉ mục.
example: 365750752
$schema:
type: string
example: https://schema.metaplex.com/nft1.0.json
json_uri:
type: string
example: >-
https://madlads.s3.us-west-2.amazonaws.com/json/8420.json
files:
type: array
items:
type: object
example:
- 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
metadata:
type: object
properties:
attributes:
type: array
items:
type: object
example:
- value: Male
trait_type: Gender
- value: King
trait_type: Type
description:
type: string
example: Fock it.
name:
type: string
example: 'Mad Lads #8420'
symbol:
type: string
example: MAD
authorities:
type: array
items:
type: object
example:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
type: object
example:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
type: array
items:
type: object
example:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
type: object
example:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
type: array
items:
type: object
example:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
share: 100
verified: true
ownership:
type: object
example:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue
supply:
type: object
example:
print_max_supply: 0
print_current_supply: 0
edition_nonce: 254
token_info:
type: object
description: Thông tin chi tiết về token cụ thể.
properties:
symbol:
type: string
description: Ký hiệu của token.
supply:
type: integer
description: Tổng nguồn cung của token.
decimals:
type: integer
description: Số chữ số thập phân mà token sử dụng.
token_program:
type: string
description: ID chương trình token.
price_info:
type: object
description: Thông tin về giá của token.
properties:
price_per_token:
type: number
description: Giá của mỗi token riêng lẻ.
currency:
type: string
description: Loại tiền tệ dùng để biểu thị giá token.
mint_authority:
type: string
description: Địa chỉ thẩm quyền mint của token.
freeze_authority:
type: string
description: Địa chỉ thẩm quyền đóng băng của token.
'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ị từ chối truy cập. 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 một hoặc nhiều tài sản trong lô.
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).
````