MỚI: Helius mua lại Light Protocol
Wallet API (Beta)

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.

Hình ảnh chính
DANH TÍNH

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

GET /v1/wallet/{wallet}/identity
          
{ "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ờ
NGUỒN CẤP VỐN

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.

GET /v1/wallet/{wallet}/funded-by
          
{ "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
LỊCH SỬ

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.

GET /v1/wallet/{wallet}/history
          
{ "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ật
  • amount đã được điều chỉnh theo số thập phân; không cần tính toán lamport
HELIUS WALLETS-AS-A-SERVICE

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

CÁCH HOẠT ĐỘNG

Một REST API cho toàn bộ dữ liệu ví Solana

getWalletBalances
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

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.

trải nghiệm sự khác biệt

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