> ## 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.

# Solana DAS API: Quyền truy cập hợp nhất vào dữ liệu NFT và token

> API Solana toàn diện nhất dành cho NFT, NFT nén và token. Một giao diện hợp nhất cho mọi tài sản kỹ thuật số, với đầy đủ siêu dữ liệu, thông tin quyền sở hữu và khả năng tìm kiếm.

## DAS API là gì?

Digital Asset Standard (DAS) API là một đặc tả nguồn mở cung cấp cho bạn một giao diện hợp nhất cho mọi loại tài sản kỹ thuật số trên Solana:

* NFT thông thường (Token không thể thay thế)
* NFT nén (cNFT, sử dụng cơ chế nén trạng thái)
* Token có thể thay thế (SPL Token và Token-2022, bao gồm cả các phần mở rộng)

Một bộ phương thức duy nhất bao quát siêu dữ liệu, quyền sở hữu, số dư, bộ sưu tập, nhà sáng tạo, tìm kiếm và bằng chứng Merkle — nhờ đó, bạn có thể xây dựng sàn giao dịch NFT, ví, công cụ theo dõi danh mục đầu tư, ứng dụng kiểm soát quyền truy cập bằng token và công cụ phân tích trên cùng một API.

Cả hai mạng đều sử dụng cùng các phương thức:

* Mainnet: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* Devnet: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`

## Tại sao nên dùng Helius cho DAS API?

<CardGroup cols={2}>
  <Card title="All asset types, one API" icon="gem">
    NFT, NFT nén và token có thể thay thế (SPL và Token-2022) thông qua một giao diện duy nhất.
  </Card>

  <Card title="Complete metadata" icon="database">
    Dữ liệu on-chain và off-chain (Arweave, IPFS) được lập chỉ mục và trả về cùng nhau trong một lệnh gọi.
  </Card>

  <Card title="Price data included" icon="coins">
    Thông tin giá bằng USD của các token đã xác minh được trả về cùng với số dư.
  </Card>

  <Card title="Search and filtering" icon="magnifying-glass">
    Truy vấn theo chủ sở hữu, bộ sưu tập, nhà sáng tạo, thẩm quyền hoặc các bộ lọc thuộc tính nâng cao.
  </Card>
</CardGroup>

## Tôi nên sử dụng phương thức nào?

Hầu hết quy trình tích hợp bắt đầu bằng một trong ba phương thức. Hãy sử dụng bảng này để chọn điểm bắt đầu phù hợp, sau đó dùng các phương thức chuyên biệt bên dưới.

| Phương thức            | Dùng để                                   | Trả về                                                                           |
| ---------------------- | ----------------------------------------- | -------------------------------------------------------------------------------- |
| **`getAsset`**         | Một tài sản duy nhất mà bạn đã có ID      | Toàn bộ siêu dữ liệu, quyền sở hữu và giá của một tài sản (đối với token)        |
| **`getAssetsByOwner`** | Mọi tài sản mà một ví nắm giữ             | Tất cả tài sản của một địa chỉ, kèm siêu dữ liệu và số dư                        |
| **`searchAssets`**     | Các truy vấn có bộ lọc trên nhiều tài sản | Các tài sản khớp với bộ lọc về chủ sở hữu, bộ sưu tập, `tokenType` và thuộc tính |

Theo nguyên tắc chung:

* Biết chính xác ID tài sản? Dùng `getAsset` (hoặc `getAssetBatch` cho nhiều tài sản).
* Liệt kê tài sản mà một ví nắm giữ? Dùng `getAssetsByOwner`.
* Lọc theo bộ sưu tập, loại token hoặc thuộc tính? Dùng `searchAssets`.

## Các phương thức chính

### Một tài sản

<CardGroup cols={2}>
  <Card title="getAsset" icon="gem" href="/docs/vi/api-reference/das/getasset">
    Toàn bộ dữ liệu của một tài sản theo ID.
  </Card>

  <Card title="getAssetBatch" icon="layer-group" href="/docs/vi/api-reference/das/getassetbatch">
    Tối đa 1.000 tài sản trong một yêu cầu duy nhất.
  </Card>
</CardGroup>

### Tài sản theo chủ sở hữu, bộ sưu tập hoặc nhà sáng tạo

<CardGroup cols={2}>
  <Card title="getAssetsByOwner" icon="wallet" href="/docs/vi/api-reference/das/getassetsbyowner">
    Tất cả tài sản do một ví nắm giữ, kèm siêu dữ liệu và số dư.
  </Card>

  <Card title="getAssetsByGroup" icon="layer-group" href="/docs/vi/api-reference/das/getassetsbygroup">
    Tất cả tài sản trong một bộ sưu tập (khóa nhóm `collection`).
  </Card>

  <Card title="getAssetsByCreator" icon="user" href="/docs/vi/api-reference/das/getassetsbycreator">
    Tất cả tài sản được đúc bởi một nhà sáng tạo cụ thể.
  </Card>

  <Card title="getAssetsByAuthority" icon="address-card" href="/docs/vi/api-reference/das/getassetsbyauthority">
    Tất cả tài sản do một thẩm quyền nhất định kiểm soát.
  </Card>
</CardGroup>

### Tìm kiếm

<CardGroup cols={2}>
  <Card title="searchAssets" icon="magnifying-glass" href="/docs/vi/api-reference/das/searchassets">
    Lọc linh hoạt theo chủ sở hữu, bộ sưu tập, `tokenType` và thuộc tính.
  </Card>
</CardGroup>

### Tài sản nén và bằng chứng

<CardGroup cols={2}>
  <Card title="getAssetProof" icon="shield-check" href="/docs/vi/api-reference/das/getassetproof">
    Bằng chứng Merkle cho một tài sản nén, cần thiết cho các thao tác on-chain.
  </Card>

  <Card title="getAssetProofBatch" icon="shield-check" href="/docs/vi/api-reference/das/getassetproofbatch">
    Bằng chứng Merkle cho nhiều tài sản nén cùng lúc.
  </Card>

  <Card title="getSignaturesForAsset" icon="clock-rotate-left" href="/docs/vi/api-reference/das/getsignaturesforasset">
    Lịch sử chữ ký giao dịch của một tài sản.
  </Card>

  <Card title="getNftEditions" icon="image" href="/docs/vi/api-reference/das/getnfteditions">
    Tất cả các phiên bản được tạo từ một NFT gốc.
  </Card>
</CardGroup>

### Tài khoản token

<CardGroup cols={2}>
  <Card title="getTokenAccounts" icon="coins" href="/docs/vi/api-reference/das/gettokenaccounts">
    Tài khoản token theo địa chỉ đúc hoặc chủ sở hữu, kèm số dư.
  </Card>
</CardGroup>

## Bắt đầu

<CardGroup cols={2}>
  <Card title="Get Assets (NFTs)" icon="image" href="/docs/vi/das/get-nfts">
    Truy xuất NFT và vật phẩm sưu tầm kỹ thuật số: từng tài sản, theo chủ sở hữu, bộ sưu tập, bằng chứng và phiên bản.
  </Card>

  <Card title="Get SPL Tokens" icon="coins" href="/docs/vi/das/get-tokens">
    Truy vấn token có thể thay thế: số dư, nguồn cung, người nắm giữ và tài khoản token.
  </Card>

  <Card title="Search Assets" icon="magnifying-glass" href="/docs/vi/das/search">
    Lọc tài sản theo chủ sở hữu, bộ sưu tập, loại token và thuộc tính.
  </Card>

  <Card title="Pagination" icon="list" href="/docs/vi/das/pagination">
    Phân trang theo trang và theo khóa cho các tập kết quả lớn.
  </Card>
</CardGroup>

## Làm việc với các loại tài sản đặc biệt

### Token có thể thay thế

Helius mở rộng DAS API để hỗ trợ **tất cả token**, bao gồm token SPL thông thường (không có siêu dữ liệu) và Token-2022 (cùng các phần mở rộng của chúng). Tính năng hỗ trợ token có thể thay thế được cung cấp thông qua `getAsset`, `getAssetsByOwner` và `searchAssets` bằng tham số `tokenType`; giá của các token đã xác minh được trả về trong `token_info.price_info`.

Để truy vấn số dư, nguồn cung, người nắm giữ và tài khoản token, hãy xem [hướng dẫn Lấy SPL Token](/docs/vi/das/get-tokens) và [phần mở rộng token có thể thay thế](/docs/vi/das/fungible-token-extension).

### NFT nén

NFT nén trạng thái (cNFT) sử dụng cùng các phương thức đọc như NFT thông thường (`getAsset`, `getAssetsByOwner`, `searchAssets`), cùng với hai phương thức dành riêng cho cơ chế nén:

* `getAssetProof` trả về bằng chứng Merkle cần thiết để xác minh và thực hiện các thao tác on-chain như chuyển và đốt.
* `getSignaturesForAsset` trả về lịch sử giao dịch của một tài sản nén.

Xem [hướng dẫn Lấy tài sản](/docs/vi/das/get-nfts) để tham khảo đầy đủ các ví dụ về NFT nén.

### Dữ liệu off-chain

Hầu hết các bộ sưu tập NFT lưu trữ siêu dữ liệu bổ sung (thuộc tính, hình ảnh) trên Arweave hoặc IPFS ở ngoài chuỗi. DAS API lập chỉ mục dữ liệu off-chain này và trả về cùng với dữ liệu on-chain trong một lệnh gọi duy nhất.

<Note>
  Helius không thể phát hiện các thay đổi đối với dữ liệu off-chain. Dữ liệu off-chain chỉ được làm mới khi tài sản xuất hiện trở lại on-chain (ví dụ: khi tài sản được sửa đổi). Để yêu cầu lập chỉ mục lại, hãy liên hệ với bộ phận hỗ trợ của Helius.
</Note>

## Các phương pháp hay nhất

<CardGroup cols={2}>
  <Card title="Pagination" icon="list">
    Bắt đầu từ trang 1 (không phải 0). Đặt giới hạn từ 100–1.000 và phân trang đối với các tập dữ liệu lớn.
  </Card>

  <Card title="Error handling" icon="shield-check">
    Kiểm tra lỗi trong mọi phản hồi và thử lại với thời gian chờ tăng theo cấp số nhân.
  </Card>

  <Card title="Performance" icon="bolt">
    Sử dụng các phương thức xử lý hàng loạt khi có thể, lưu phản hồi vào bộ nhớ đệm và tránh nối chuỗi nhiều lệnh gọi khi chỉ cần một lệnh gọi.
  </Card>

  <Card title="Security" icon="lock">
    Tuyệt đối không để lộ khóa API trong mã phía máy khách. Chuyển tiếp yêu cầu qua máy chủ và thiết lập các chính sách CORS.
  </Card>
</CardGroup>

## Các bước tiếp theo

<CardGroup cols={3}>
  <Card title="Get Assets (NFTs)" icon="image" href="/docs/vi/das/get-nfts">
    Truy xuất và truy vấn NFT cùng các vật phẩm sưu tầm kỹ thuật số.
  </Card>

  <Card title="DAS API reference" icon="code" href="/docs/vi/api-reference/das">
    Lược đồ đầy đủ của yêu cầu và phản hồi cho mọi phương thức DAS.
  </Card>

  <Card title="DAS API FAQ" icon="book" href="/docs/vi/faqs/das-api">
    Các câu hỏi thường gặp về tài sản, dữ liệu giá và cách sử dụng.
  </Card>
</CardGroup>