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
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
Tài khoản token bằng DAS API
Phương thức DASgetTokenAccounts 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
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 DASgetAsset 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
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: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.