Dữ liệu ví Solana trở nên đơn giản
Một REST API để lấy số dư, lịch sử, danh tính và nguồn cấp vốn của ví Solana. Không cần ghi nhớ các phương thức Solana JSON-RPC hay tính toán lamport.



Biết chủ thể đứng sau một ví
Phân giải địa chỉ hoặc tên miền Solana thành danh tính. Hỗ trợ hơn 32.500 nhãn và hơn 21,5 triệu thẻ.
- Tra cứu riêng lẻ hoặc theo lô tối đa 100 địa chỉ
- Phân giải TLD tùy chỉnh của SNS và ANS trên mainnet
- Hỗ trợ nhãn cho địa chỉ sàn giao dịch, ví giao thức, tổ chức và địa chỉ bị gắn cờ
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
- Tra cứu riêng lẻ hoặc theo lô tối đa 100 địa chỉ
- Phân giải TLD tùy chỉnh của SNS và ANS trên mainnet
- Hỗ trợ nhãn cho địa chỉ sàn giao dịch, ví giao thức, tổ chức và địa chỉ bị gắn cờ
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
Truy vết nguồn cấp vốn cho ví
Nguồn cấp vốn ban đầu của ví: ai đã gửi SOL đầu tiên, số lượng bao nhiêu và vào thời điểm nào. Tên và loại bên cấp vốn đến từ cùng hệ thống danh tính.
- Địa chỉ bên cấp vốn trực tiếp, số tiền, slot và chữ ký
- Sàn giao dịch, giao thức hoặc không xác định, kèm nhãn nếu có dữ liệu
- Lưu vào bộ nhớ đệm vĩnh viễn. Bên cấp vốn đầu tiên của ví không bao giờ thay đổi
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
- Địa chỉ bên cấp vốn trực tiếp, số tiền, slot và chữ ký
- Sàn giao dịch, giao thức hoặc không xác định, kèm nhãn nếu có dữ liệu
- Lưu vào bộ nhớ đệm vĩnh viễn. Bên cấp vốn đầu tiên của ví không bao giờ thay đổi
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
Hoạt động ví được phân tích đầy đủ
Lịch sử giao dịch với thay đổi số dư của từng giao dịch bằng ngôn ngữ dễ đọc.
- Mới nhất trước, tối đa 100 giao dịch mỗi trang
tokenAccounts=balanceChangedđể chỉ nhận các cập nhậtamountđã được điều chỉnh theo số thập phân; không cần tính toán lamport
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
- Mới nhất trước, tối đa 100 giao dịch mỗi trang
tokenAccounts=balanceChangedđể chỉ nhận các cập nhậtamountđã được điều chỉnh theo số thập phân; không cần tính toán lamport
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
Triển khai ví và lớp dữ liệu cùng lúc
Thêm ví nhúng không lưu ký vào ứng dụng với khả năng đăng nhập bằng passkey, email và ví hiện có thông qua helius-wallet-kit
Các trường hợp sử dụng Wallet API
Bảng điều khiển ví
Số dư, giá trị USD và siêu dữ liệu trong một lệnh gọi REST. Không cần ghép nối DAS hay tính toán lamport
Công cụ theo dõi danh mục đầu tư
Sử dụng lịch sử và balance-at để dựng lại tài sản nắm giữ và tính lãi/lỗ theo thời gian
Bộ xử lý thanh toán
Ghi lại giao dịch và giao dịch chuyển tiền cùng đối tác, số tiền, mint và hướng giao dịch
Thuế và kế toán
Nhận lịch sử dễ đọc cùng lượng tài sản nắm giữ và thay đổi số dư theo từng giao dịch
Tuân thủ và AML
Tra cứu các sàn giao dịch và ví ngân quỹ đã biết, xem ví được cấp vốn như thế nào
Trình khám phá và phân tích
Nhận thẻ cho hơn 21 triệu ví để thêm nhãn tài khoản vào ứng dụng
Một REST API cho toàn bộ dữ liệu ví Solana
1. Nhận API key
Đăng ký, nhận Helius API key rồi truyền api-key trong chuỗi truy vấn hoặc dưới dạng header X-Api-Key
2. Gọi một đường dẫn REST
GET /v1/wallet/{wallet}/balances, identity, history hoặc bất kỳ endpoint Wallet API nào khác
3. Tích hợp vào ứng dụng
Số tiền đã được điều chỉnh theo số thập phân, danh tính được gắn nhãn và dữ liệu được định dạng chính xác; không cần thêm bước nào
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");1. Nhận API key
Đăng ký, nhận Helius API key rồi truyền api-key trong chuỗi truy vấn hoặc dưới dạng header X-Api-Key
2. Gọi một đường dẫn REST
GET /v1/wallet/{wallet}/balances, identity, history hoặc bất kỳ endpoint Wallet API nào khác
3. Tích hợp vào ứng dụng
Số tiền đã được điều chỉnh theo số thập phân, danh tính được gắn nhãn và dữ liệu được định dạng chính xác; không cần thêm bước nào
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");Câu hỏi thường gặp
Xem câu trả lời cho các câu hỏi thường gặp. Cần trợ giúp hoặc gói tùy chỉnh? Hãy liên hệ với đội ngũ của chúng tôi.
Số dư, số dư lịch sử (balance-at), lịch sử và giao dịch chuyển tiền có trên mọi gói, bao gồm Free. Danh tính (riêng lẻ và theo lô) cùng funded-by yêu cầu bất kỳ gói trả phí nào (Developer trở lên) và trả về 403 trên Free.
Mỗi yêu cầu Wallet API tốn 100 credit, bao gồm cả danh tính theo lô (tối đa 100 địa chỉ trong một lệnh gọi). Xem toàn bộ bảng credit.
Dùng balances cho danh mục đầu tư hiện tại, balance-at cho lượng tài sản nắm giữ tại một slot hoặc dấu thời gian trong quá khứ, history cho nguồn cấp dữ liệu hoạt động đầy đủ với thay đổi số dư theo từng giao dịch và transfers khi chỉ cần các khoản thanh toán đã gửi hoặc nhận cùng đối tác. Dùng identity để gắn nhãn cho sàn giao dịch, giao thức hoặc tổ chức đã biết và funded-by để tìm ví đã gửi SOL đầu tiên.
Wallet API là đường dẫn đọc: lấy số dư, lịch sử, danh tính và thông tin về ví cấp vốn qua REST. WaaS cung cấp ví nhúng: tạo và ký giao dịch bằng helius-wallet-kit.
WaaS đang ở giai đoạn beta và có trên tất cả gói trả phí (Developer, Business, Professional và Enterprise). Dịch vụ này không có trên Free.
Không có phí đăng ký riêng hay phí theo người dùng. Mỗi chữ ký tốn 200 credit (0,001 USD theo mức giá credit tiêu chuẩn). Tạo ví miễn phí. Mỗi thao tác signMessage, signTransaction và signAndSendTransaction được tính là một chữ ký. Chữ ký vẫn bị tính phí ngay cả khi giao dịch sau đó thất bại trên chuỗi. Lời nhắc bị hủy không mất phí. Theo dõi mức sử dụng trong bảng điều khiển tại WaaS → Analytics. Xem credit WaaS.
Nâng cấp lên gói trả phí, tạo API key và cài đặt helius-wallet-kit. Bao bọc ứng dụng trong HeliusWalletProvider và làm theo hướng dẫn bắt đầu nhanh với WaaS.
Để bắt đầu, hãy khám phá các tài nguyên sau:
Dữ liệu ví không còn phức tạp
Bỏ qua các phương thức Solana JSON-RPC thô và bắt đầu truy vấn dữ liệu ví trên chuỗi chỉ trong vài phút




