> ## 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.
# searchAssets
> Tìm kiếm và lọc NFT Solana, NFT nén và token bằng các tiêu chí linh hoạt, bao gồm quyền sở hữu, người tạo, bộ sưu tập và thuộc tính tùy chỉnh
## Tham số yêu cầu
Địa chỉ ví Solana dùng để truy xuất các tài sản kỹ thuật số thuộc quyền sở hữu nhằm lọc kết quả tìm kiếm.
Lọc theo các loại token Solana cụ thể, bao gồm NFT nén (cNFT), NFT thông thường,
NFT có thể lập trình (pNFT) hoặc token SPL có thể thay thế để tìm chính xác tài sản cần thiết.
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
Trang kết quả cần trả về.
Tiêu chí địa chỉ có thẩm quyền dùng để lọc tài sản kỹ thuật số Solana dựa trên thẩm quyền của chương trình,
hữu ích khi tìm các tài sản do giao thức hoặc thẩm quyền cập nhật cụ thể kiểm soát.
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 tài sản.
* `created`
* `recent_action`
* `updated`
* `none`
Hướng sắp xếp.
* `asc`
* `desc`
Lọc các NFT Solana nén (cNFT) sử dụng công nghệ nén trạng thái
để giảm chi phí lưu trữ và cải thiện khả năng mở rộng.
Lọc các tài sản Solana đủ điều kiện nén nhưng chưa được
nén sang định dạng nén trạng thái.
Tiêu chí người được ủy quyền cho tìm kiếm tài sản.
Tiêu chí địa chỉ ví của người tạo dùng để tìm các NFT Solana do nghệ sĩ,
dự án hoặc người tạo cụ thể tạo ra nhằm ghi nhận nguồn gốc và theo dõi tiền bản quyền.
Cho biết người tạo đã được xác minh hay chưa.
Mảng nhóm bộ sưu tập dùng để lọc NFT Solana theo tư cách thành viên bộ sưu tập
(ví dụ: \["collection", "\"]) nhằm tìm các tài sản liên quan.
Địa chỉ cây Merkle dùng để lọc NFT nén (cNFT) theo cây bộ sưu tập.
Tham số này dành riêng cho Helius và không thuộc đặc tả DAS chính thức.
Tiêu chí nguồn cung cho tìm kiếm tài sản.
Tiêu chí mint nguồn cung cho tìm kiếm tài sản.
Cho biết tài sản có bị đóng băng hay không.
Cho biết tài sản đã bị đốt hay chưa.
Lọc các tài sản có Danh tính tác nhân (plugin bên ngoài MPL Core AgentIdentity).
Lọc theo địa chỉ mint token tác nhân dạng base58 từ chương trình Agent Registry.
Lọc theo PDA ký tài sản dạng base58 (MPL Core).
Loại giao diện tiêu chuẩn token Solana dùng để lọc các cách triển khai NFT cụ thể,
bao gồm NFT có thể lập trình, NFT cũ, token có thể thay thế và tài sản, bộ sưu tập hoặc nhóm MPL Core (MIP-11).
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
Tiêu chí loại đối tượng nhận tiền bản quyền.
Tiêu chí đối tượng nhận tiền bản quyền.
Tiêu chí số tiền bản quyền.
Tiêu chí mô hình sở hữu.
Con trỏ để phân trang về trước.
Con trỏ để phân trang về sau.
Các tùy chọn hiển thị nâng cao để tùy chỉnh phản hồi tìm kiếm tài sản Solana.
Hiển thị 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 tiêu chí (yêu cầu chậm hơn).
Hiển thị số dư gốc (SOL) của chủ sở hữu.
Hiển thị các tài sản có số dư bằng 0.
## OpenAPI
````yaml vi/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: API khám phá và tìm kiếm NFT Solana
version: 1.0.0
description: >
API Digital Asset Standard (DAS) nâng cao cho Solana, dùng để tìm kiếm và
khám phá NFT, token và các tài sản kỹ thuật số khác trong toàn bộ hệ sinh
thái Solana với khả năng lọc mạnh mẽ.
API tìm kiếm toàn diện này cung cấp nền tảng cho các sàn giao dịch NFT, ứng
dụng danh mục đầu tư và nền tảng phân tích
để khám phá và lọc tài sản kỹ thuật số dựa trên nhiều tiêu chí, bao gồm bộ
sưu tập, người tạo, trạng thái nén
và quyền sở hữu — hỗ trợ cả NFT truyền thống lẫn NFT nén trong toàn bộ hệ
sinh thái Solana.
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: searchAssets
description: >
Tìm kiếm và khám phá tài sản kỹ thuật số Solana với các tùy chọn lọc
toàn diện.
API khám phá mạnh mẽ này cho phép ứng dụng tìm NFT, NFT nén, token có
thể thay thế
và các tài sản kỹ thuật số khác bằng nhiều tiêu chí, bao gồm quyền sở
hữu, người tạo, bộ sưu tập,
trạng thái nén và thuộc tính siêu dữ liệu. Phù hợp với các sàn giao
dịch, công cụ theo dõi
danh mục đầu tư và nền tảng phân tích cần khả năng khám phá tài sản nâng
cao
trong toàn bộ hệ sinh thái Solana.
Các khả năng chính:
- Tìm kiếm theo nhiều tiêu chí trên tất cả tiêu chuẩn NFT Solana (truyền
thống, nén, có thể lập trình)
- Lọc theo bộ sưu tập cho các dự án và cộng đồng NFT
- Truy vấn theo người tạo và quyền sở hữu để ghi nhận tác giả và phân
tích danh mục đầu tư
- Lọc theo trạng thái nén để xác định tài sản tiết kiệm chi phí
- Tìm kiếm thuộc tính siêu dữ liệu để khám phá theo đặc điểm
- Hỗ trợ phân trang đầy đủ cho tập kết quả lớn
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:
- searchAssets
description: Tên của phương thức JSON-RPC cần gọi.
default: searchAssets
params:
type: object
description: Các tham số cho phương thức `searchAssets`.
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: >-
Địa chỉ ví Solana dùng để truy xuất các tài sản kỹ thuật
số thuộc sở hữu nhằm lọc kết quả tìm kiếm.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >
Lọc các loại token Solana cụ thể, bao gồm NFT nén
(cNFT), NFT thông thường,
NFT có thể lập trình (pNFT) hoặc token SPL có thể thay
thế để khám phá tài sản có mục tiêu.
example: all
page:
type: integer
description: Trang kết quả cần trả về.
example: 1
authorityAddress:
type: string
description: >
Tiêu chí địa chỉ thẩm quyền để lọc tài sản kỹ thuật số
Solana dựa trên thẩm quyền của chương trình,
hữu ích khi tìm tài sản do các giao thức hoặc thẩm quyền
cập nhật cụ thể kiểm soát.
example: string
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 tài sản.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: Hướng sắp xếp.
enum:
- asc
- desc
compressed:
type: boolean
description: >
Lọc NFT Solana nén (cNFT) sử dụng công nghệ nén trạng
thái
để giảm chi phí lưu trữ và cải thiện khả năng mở rộng.
example: true
compressible:
type: boolean
description: |
Lọc các tài sản Solana đủ điều kiện nén nhưng chưa được
nén sang định dạng nén trạng thái.
example: false
delegate:
type: integer
description: Tiêu chí ủy quyền cho tìm kiếm tài sản.
creatorAddress:
type: string
description: >
Tiêu chí địa chỉ ví của người tạo để tìm NFT Solana do
nghệ sĩ,
dự án hoặc người tạo cụ thể tạo ra nhằm ghi nhận tác giả
và theo dõi tiền bản quyền.
example: string
creatorVerified:
type: boolean
description: Cho biết người tạo đã được xác minh hay chưa.
example: true
grouping:
type: array
items:
type: string
description: >
Mảng nhóm bộ sưu tập dùng để lọc NFT Solana theo tư cách
thành viên bộ sưu tập
(ví dụ: ["collection", ""]) nhằm tìm các
tài sản liên quan.
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: >
Địa chỉ cây Merkle dùng để lọc NFT nén (cNFT) theo cây
bộ sưu tập của chúng.
Tham số này dành riêng cho Helius và không thuộc đặc tả
DAS chính thức.
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: Tiêu chí nguồn cung cho tìm kiếm tài sản.
example: 0
supplyMint:
type: string
description: Tiêu chí địa chỉ mint nguồn cung cho tìm kiếm tài sản.
frozen:
type: boolean
description: Cho biết tài sản có bị đóng băng hay không.
example: false
burnt:
type: boolean
description: Cho biết tài sản đã bị đốt hay chưa.
example: false
isAgent:
type: boolean
description: >-
Lọc các tài sản có Agent Identity (plugin bên ngoài
AgentIdentity của MPL Core).
agentToken:
type: string
description: >-
Lọc theo địa chỉ mint token tác nhân base58 từ chương
trình Agent Registry.
assetSigner:
type: string
description: Lọc theo PDA người ký tài sản dạng base58 (MPL Core).
interface:
type: string
description: >
Loại giao diện tiêu chuẩn token Solana dùng để lọc các
cách triển khai NFT cụ thể,
bao gồm NFT có thể lập trình, NFT cũ, token có thể thay
thế và tài sản, bộ sưu tập hoặc nhóm MPL Core (MIP-11).
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: Custom
royaltyTargetType:
type: string
description: Tiêu chí loại đối tượng nhận tiền bản quyền.
example: creators
royaltyTarget:
type: integer
description: Tiêu chí đối tượng nhận tiền bản quyền.
example: 0
royaltyAmount:
type: integer
description: Tiêu chí số tiền bản quyền.
example: 0
ownerType:
type: integer
description: Tiêu chí mô hình sở hữu.
example: 1
before:
type: string
description: Con trỏ để phân trang về phía sau.
example: string
after:
type: string
description: Con trỏ để phân trang về phía trước.
example: string
options:
type: object
description: >-
Các tùy chọn hiển thị nâng cao để tùy chỉnh phản hồi tìm
kiếm tài sản Solana.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Hiển thị 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.
showGrandTotal:
type: boolean
default: false
description: Hiển thị tổng số tài sản khớp (yêu cầu chậm hơn).
showNativeBalance:
type: boolean
default: false
description: Hiển thị số dư gốc (SOL) của chủ sở hữu.
showZeroBalance:
type: boolean
default: false
description: Hiển thị các tài sản có số dư bằng không.
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: Phản hồi thành công
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Mọi dữ liệu tính đến và bao gồm slot này đều được đảm
bảo đã lập chỉ mục.
example: 365750752
total:
type: integer
description: >-
Tổng số NFT và tài sản kỹ thuật số Solana khớp với
tiêu chí tìm kiếm.
example: 80
limit:
type: integer
description: Số lượng tài sản tối đa được yêu cầu.
example: 50
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: >-
Loại triển khai tiêu chuẩn token Solana của tài
sản kỹ thuật số.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
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 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: >-
Mã định danh địa chỉ mint duy nhất của tài sản
kỹ thuật số Solana.
ownership:
type: object
description: >-
Chi tiết quyền sở hữu của tài sản kỹ thuật số
Solana, bao gồm chủ sở hữu và mô hình hiện tại.
content:
type: object
description: >-
Nội dung và siêu dữ liệu của tài sản kỹ thuật số
Solana, bao gồm URI, thuộc tính và phương tiện.
example:
total: 80
limit: 50
page: 1
items:
- interface: V1_NFT
id: SomeNftMintKey12345
ownership:
owner: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
ownership_model: single
content:
json_uri: https://example.com/metadata/12345.json
nativeBalance:
type: object
description: >-
Số dư SOL gốc của tài khoản ví Solana, tính bằng lamport
và giá trị USD.
properties:
lamports:
type: integer
description: Số lamport trong tài khoản.
price_per_sol:
type: number
description: Giá SOL hiện tại.
total_price:
type: number
description: Tổng giá trị SOL trong tài khoản này.
'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 ủy quyền. 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 thất bại. Thiếu khóa API hoặc khóa API 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 khớp với tiêu chí tìm kiếm.
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à nó 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).
````