Skip to main content

Tổng quan

Hướng dẫn này trình bày cách đọc token có thể thay thế trên Solana: số dư tài khoản, tài khoản token theo chủ sở hữu hoặc mint, tổng cung, những người nắm giữ nhiều nhất và tiện ích mở rộng token có thể thay thế của DAS. Helius cung cấp cả các phương thức token RPC tiêu chuẩn của Solana và các phương thức DAS bổ sung siêu dữ liệu cùng giá theo USD. Đối với NFT, NFT nén, phiên bản và bằng chứng, hãy xem hướng dẫn Lấy tài sản. Trang này tập trung vào các token có thể thay thế (SPL và Token-2022).

Khi nào nên sử dụng

Sử dụng các phương thức trên trang này khi cần:
  • Đọc số dư của một tài khoản token
  • Liệt kê mọi tài khoản token mà một ví nắm giữ
  • Tìm tất cả tài khoản nắm giữ một mint cụ thể
  • Kiểm tra tổng cung của token hoặc những người nắm giữ nhiều nhất
  • Truy xuất siêu dữ liệu token và giá theo USD cùng với số dư

Số dư tài khoản token

Lấy số dư của một tài khoản token cụ thể bằng RPC tiêu chuẩn:

API Reference

getTokenAccountBalance

Tài khoản token theo chủ sở hữu

Liệt kê tất cả tài khoản token thuộc sở hữu của một ví:

API Reference

getTokenAccountsByOwner

Tài khoản token theo mint

Liệt kê tất cả tài khoản nắm giữ một token cụ thể:

API Reference

getTokenAccountsByOwner
Để tìm mọi tài khoản nắm giữ một mint trên tất cả chủ sở hữu (không chỉ một chủ sở hữu), hãy sử dụng phương thức DAS getTokenAccounts được mô tả bên dưới.

Tổng cung token

Kiểm tra tổng cung của một token:

API Reference

getTokenSupply

Những người nắm giữ nhiều token nhất

Xác định các tài khoản nắm giữ nhiều token nhất:

API Reference

getTokenLargestAccounts
Trả về tối đa 20 tài khoản lớn nhất của mint:

Tài khoản token bằng DAS API

Phương thức DAS getTokenAccounts trả về các tài khoản token theo mint hoặc chủ sở hữu, bao gồm cả số dư, trong một lệnh gọi có phân trang duy nhất. Không giống getTokenAccountsByOwner, bạn có thể chỉ truy vấn theo mint để liệt kê mọi tài khoản nắm giữ một token trên tất cả chủ sở hữu.

API Reference

getTokenAccounts
Kết quả được phân trang; mỗi mục bao gồm tài khoản, mint, chủ sở hữu và số dư:

Siêu dữ liệu và giá token bằng DAS API

Để lấy siêu dữ liệu token và giá theo USD, hãy gọi phương thức DAS getAsset với showFungible được bật. Giá của các token đã xác minh được trả về trong token_info.price_info.
Dữ liệu giá từ getAsset được lưu vào bộ nhớ đệm trong tối đa 600 giây, vì vậy dữ liệu có thể cũ đến 10 phút.

API Reference

getAsset
Phản hồi trả về tổng cung, số chữ số thập phân và giá trong token_info:

Tính vốn hóa thị trường

Nhân giá với tổng cung đã điều chỉnh theo số chữ số thập phân:
Để liệt kê mọi token có thể thay thế trong một ví (kèm theo số dư và giá) chỉ bằng một lệnh gọi, hãy sử dụng getAssetsByOwner hoặc searchAssets cùng với tokenType: "fungible". Xem tiện ích mở rộng token có thể thay thế để biết tokenType, số dư, tiện ích mở rộng Token-2022 và dữ liệu giá xuất hiện như thế nào trong phản hồi.

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

  • Sử dụng phân trang cho các phương thức trả về tập kết quả lớn. Xem hướng dẫn Phân trang.
  • Ưu tiên các phương thức DAS (getAsset, getAssetsByOwner, getTokenAccounts) khi cần siêu dữ liệu hoặc giá theo USD; sử dụng các phương thức RPC tiêu chuẩn để lấy số dư và tổng cung thô trên chuỗi.
  • Xử lý lỗi phù hợp bằng các khối try/catch và cơ chế thử lại.
  • Lưu phản hồi vào bộ nhớ đệm khi thích hợp để giảm số lệnh gọi API.

Các bước tiếp theo

Fungible Token Extension

Cách DAS trả về token có thể thay thế, tiện ích mở rộng Token-2022 và giá.

Get Assets (NFTs)

Truy xuất NFT, NFT nén, phiên bản và bằng chứng.

DAS API reference

Lược đồ đầy đủ cho mọi phương thức DAS.