Skip to main content
Wallet API đang ở giai đoạn Beta. Các điểm cuối và định dạng phản hồi có thể thay đổi.

​
Wallet API là gì?

Wallet API cung cấp các điểm cuối REST cấp cao để truy vấn toàn bộ dữ liệu ví Solana — số dư, lịch sử giao dịch, giao dịch chuyển token, phân giải danh tính, số dư trong quá khứ và nguồn cấp vốn. Thay vì thực hiện nhiều lệnh gọi RPC và phân tích dữ liệu blockchain thô, bạn nhận được thông tin có cấu trúc, dễ đọc cùng mức giá theo USD trong một yêu cầu duy nhất. API này được xây dựng cho ví, công cụ theo dõi danh mục đầu tư, trình khám phá, bộ xử lý thanh toán, công cụ thuế cũng như các hệ thống tuân thủ và AML. Tất cả điểm cuối đều dùng chung URL cơ sở https://api.helius.xyz và trả về số lượng theo đơn vị dễ đọc (không cần chuyển đổi lamport).

​
Tại sao nên dùng Helius cho dữ liệu ví?

One REST call

Số dư, lịch sử và giao dịch chuyển có cấu trúc mà không cần ghép nối các phản hồi RPC thô.

USD pricing built in

Số dư token bao gồm giá trị theo USD và tổng giá trị danh mục đầu tư, lấy từ DAS.

Identity resolution

Hơn 32.500 tài khoản và chương trình được gắn nhãn cùng hơn 21,5 triệu thẻ phân loại cho các sàn giao dịch, giao thức và tổ chức.

Human-readable output

Dữ liệu rõ ràng, đã điều chỉnh theo số thập phân thay vì lamport và lệnh thô.

​
Các điểm cuối chính

Wallet Identity

Xác định các ví đã biết bằng địa chỉ hoặc tên miền SNS/ANS — sàn giao dịch, giao thức, tổ chức.

Wallet Balances

Tất cả số dư token và NFT cùng giá trị theo USD, logo và siêu dữ liệu.

Historical Balance

Số dư token hoặc SOL tại một dấu thời gian, ngày giờ hoặc slot trong quá khứ.

Wallet History

Toàn bộ lịch sử giao dịch cùng các thay đổi số dư của từng giao dịch.

Token Transfers

Tất cả giao dịch chuyển đến và đi cùng thông tin người gửi/người nhận.

Funding Source

Nguồn cấp vốn ban đầu của ví, được truy vết đến khoản SOL đầu tiên được chuyển vào.

​
Nên sử dụng điểm cuối nào?

Tham khảo nhanh các tuyến cơ sở (URL cơ sở https://api.helius.xyz):
  • GET /v1/wallet/{wallet}/identity — lấy danh tính ví bằng địa chỉ hoặc tên miền SNS/ANS
  • POST /v1/wallet/batch-identity — tra cứu danh tính hàng loạt (tối đa 100 địa chỉ và/hoặc tên miền)
  • GET /v1/wallet/{wallet}/balances — lấy tất cả số dư token và NFT
  • GET /v1/wallet/{wallet}/balance-at — lấy số dư token hoặc SOL tại một dấu thời gian, ngày giờ hoặc slot trong quá khứ
  • GET /v1/wallet/{wallet}/history — lấy lịch sử giao dịch cùng các thay đổi số dư
  • GET /v1/wallet/{wallet}/transfers — lấy toàn bộ hoạt động chuyển token
  • GET /v1/wallet/{wallet}/funded-by — tìm nguồn cấp vốn ban đầu

​
Xác thực

Tất cả yêu cầu Wallet API đều cần khóa API. Bạn có thể truyền khóa dưới dạng tham số truy vấn hoặc tiêu đề:

​
Yêu cầu về gói dịch vụ

Các điểm cuối về danh tính và nguồn cấp vốn yêu cầu gói trả phí. Với gói Free, yêu cầu đến các điểm cuối này trả về 403 Forbidden. Mọi điểm cuối khác đều khả dụng trên tất cả các gói, bao gồm Free. Bất kỳ cấp trả phí nào cũng mở khóa các điểm cuối bị giới hạn — Developer, Business và mọi cấp cao hơn (chẳng hạn như Enterprise). Để bật tính năng tra cứu danh tính và nguồn cấp vốn, hãy nâng cấp gói trong bảng điều khiển.

​
Số lượng và đơn vị

Wallet API là một lớp trừu tượng cấp cao trên dữ liệu Solana thô. Tất cả trường amount trong phản hồi đều dễ đọc — đã được chia cho decimals của token — vì vậy bạn có thể hiển thị trực tiếp mà không cần chuyển đổi. Các lệnh gọi RPC Solana thô trả về giá trị theo lamport (đơn vị nhỏ nhất, 10⁻⁹ SOL); Wallet API thì không. "amount": 1.5 có nghĩa là 1,5 SOL, không phải 1,5 lamport. Khi cần phép tính chính xác, một số điểm cuối cũng cung cấp amountRaw: cùng một giá trị dưới dạng số nguyên thô được tuần tự hóa thành chuỗi để tránh mất độ chính xác của số dấu phẩy động. Công thức chuyển đổi là: amount = parseInt(amountRaw) / 10**decimals Sử dụng amount để hiển thị. Sử dụng amountRaw khi truyền giá trị vào các lệnh trên chuỗi hoặc những hệ thống khác yêu cầu phép tính số nguyên chính xác.

​
Bắt đầu

1

Get your API key

Đăng ký tại dashboard.helius.dev để nhận khóa API.
2

Choose your endpoint

Sử dụng bảng trên để chọn điểm cuối phù hợp với trường hợp sử dụng của bạn.
3

Make your first request

Bắt đầu bằng một truy vấn số dư đơn giản:
4

Handle the response

Phân tích phản hồi JSON và hiển thị dữ liệu trong ứng dụng của bạn.

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

Getting Data

Khám phá mọi cách truy vấn dữ liệu Solana trên Helius.

API Reference

Lược đồ yêu cầu và phản hồi cho tất cả điểm cuối Wallet API.

Contact Support

Nhận trợ giúp qua Discord, trò chuyện hoặc email.