Skip to main content
GET
Lấy số dư lịch sử
Mỗi yêu cầu tốn 100 tín dụng.

Tham số yêu cầu

string
mặc định:"GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz"
bắt buộc
Địa chỉ ví Solana (được mã hóa bằng base58)
string
mặc định:"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
bắt buộc
Địa chỉ mint của token. Đối với SOL gốc, hãy dùng So11111111111111111111111111111111111111111.
number
mặc định:"1750000000"
Dấu thời gian Unix tính bằng giây. Trả về số dư tại thời điểm này. Chỉ cung cấp một trong các giá trị time, datetime hoặc slot.
string
Chuỗi ngày giờ. Các định dạng được chấp nhận: 2025-01-10 (nửa đêm theo UTC), 2025-01-10 19:20:00, 2025-01-10T19:20:00 (phần giây là tùy chọn) hoặc kèm múi giờ rõ ràng (2025-01-10T19:20:00Z, ...+02:00). Được hiểu là UTC trừ khi có chỉ định múi giờ rõ ràng. Chỉ cung cấp một trong các giá trị time, datetime hoặc slot.
number
Số slot. Trả về số dư tại slot này. Chính xác và có tính xác định. Chỉ cung cấp một trong các giá trị time, datetime hoặc slot.

Ủy quyền

api-key
string
query
bắt buộc

Khóa API được truyền dưới dạng tham số truy vấn

Tham số đường dẫn

wallet
string
mặc định:GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
bắt buộc

Địa chỉ ví Solana (được mã hóa base58)

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Tham số truy vấn

mint
string
mặc định:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
bắt buộc

Địa chỉ mint của token. Đối với SOL gốc, dùng So11111111111111111111111111111111111111111.

time
integer
mặc định:1750000000

Dấu thời gian Unix tính bằng giây. Trả về số dư tại thời điểm này. Cung cấp chính xác một trong time, datetime hoặc slot.

Phạm vi bắt buộc: x >= 0
datetime
string

Chuỗi ngày giờ. Các định dạng được chấp nhận: 2025-01-10 (nửa đêm UTC), 2025-01-10 19:20:00, 2025-01-10T19:20:00 (phần giây không bắt buộc), hoặc có múi giờ rõ ràng (2025-01-10T19:20:00Z, ...+02:00). Được hiểu là UTC trừ khi có múi giờ rõ ràng. Cung cấp chính xác một trong time, datetime hoặc slot.

slot
integer

Số slot. Trả về số dư tại slot này. Chính xác và xác định. Cung cấp chính xác một trong time, datetime hoặc slot.

Phạm vi bắt buộc: x >= 0

Phản hồi

Đã truy xuất số dư lịch sử thành công

wallet
string
bắt buộc

Giá trị lặp lại của địa chỉ ví đã truy vấn

Ví dụ:

"5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9"

mint
string
bắt buộc

Giá trị lặp lại của mint đã truy vấn (pseudo-mint SOL khi là token gốc)

Ví dụ:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

isNative
boolean
bắt buộc

Cho biết kết quả có phải SOL gốc hay không

Ví dụ:

false

balance
string
bắt buộc

Số lượng dễ đọc dưới dạng chuỗi thập phân (không phải số, để số dư lớn không mất độ chính xác). Các số 0 ở cuối bị loại bỏ.

Ví dụ:

"284961463.392936"

balanceRaw
string
bắt buộc

Số lượng chính xác theo đơn vị nhỏ nhất (lamport đối với SOL), dưới dạng chuỗi

Ví dụ:

"284961463392936"

decimals
integer
bắt buộc

Số chữ số thập phân của token (9 đối với SOL)

Ví dụ:

6

requested
object
bắt buộc

Giá trị lặp lại của truy vấn. Khi dùng datetime, time cũng được điền bằng số giây epoch đã phân giải để thể hiện cách diễn giải UTC.

asOf
object | null
bắt buộc

Giao dịch dùng để đọc số dư. Là null khi ví không có giao dịch phù hợp tại hoặc trước thời điểm được yêu cầu — nghĩa là số dư thực sự là 0 (ví chưa nắm giữ token vào thời điểm đó), không phải lỗi.