Skip to main content
POST
getTransfersByAddress

Tổng quan

getTransfersByAddress trả về các đối tượng chuyển đã được phân tích, ở định dạng dễ đọc, cho các giao dịch chuyển token và SOL gốc có liên quan đến một địa chỉ ví. Sử dụng bộ lọc để thu hẹp kết quả theo địa chỉ mint, thời gian khối, số lượng, slot, hướng chuyển hoặc đối tác. Phản hồi được thiết kế để hiển thị chính xác hoạt động ví, theo dõi thanh toán và đối soát số dư mà không cần triển khai lại logic phân tích giao dịch chuyển của Solana.
Các giao dịch mint và đốt chỉ có một phía. Giao dịch mint có fromUserAccount: null và chỉ có thể được trả về dưới dạng giao dịch chuyển vào cho người nhận. Giao dịch đốt có toUserAccount: null và chỉ có thể được trả về dưới dạng giao dịch chuyển ra cho chủ sở hữu thực hiện đốt.

Tham số yêu cầu

string
bắt buộc
Địa chỉ ví của chủ sở hữu được mã hóa Base58 cần truy vấn giao dịch chuyển. Truyền địa chỉ chủ sở hữu ví, không phải tài khoản token liên kết (ATA).
string
Lọc theo địa chỉ đối tác. Chỉ trả về các giao dịch chuyển đến hoặc từ địa chỉ này.
string
mặc định:"any"
Lọc theo hướng chuyển so với địa chỉ được truy vấn.
  • in
  • out
  • any
string
Địa chỉ mint của token. Sử dụng So11111111111111111111111111111111111111111 cho SOL gốc và So11111111111111111111111111111111111111112 cho WSOL.
string
mặc định:"merged"
Chế độ hiển thị SOL/WSOL. merged xem WSOL như SOL gốc và loại trừ các hàng bọc/mở bọc để lịch sử được định giá bằng SOL dễ đối soát hơn; separate giữ WSOL dưới dạng một địa chỉ mint token SPL riêng biệt và bao gồm các hàng bọc/mở bọc.
  • merged
  • separate
object
Các bộ lọc bổ sung cho số lượng, thời gian khối và slot.
object
Bộ lọc so sánh theo phạm vi. Tất cả các trường đều không bắt buộc và có thể kết hợp với nhau.
number
Lớn hơn.
number
Lớn hơn hoặc bằng.
number
Nhỏ hơn.
number
Nhỏ hơn hoặc bằng.
object
Bộ lọc so sánh theo phạm vi. Tất cả các trường đều không bắt buộc và có thể kết hợp với nhau.
number
Lớn hơn.
number
Lớn hơn hoặc bằng.
number
Nhỏ hơn.
number
Nhỏ hơn hoặc bằng.
object
Bộ lọc so sánh theo phạm vi. Tất cả các trường đều không bắt buộc và có thể kết hợp với nhau.
number
Lớn hơn.
number
Lớn hơn hoặc bằng.
number
Nhỏ hơn.
number
Nhỏ hơn hoặc bằng.
number
mặc định:"100"
Số lượng giao dịch chuyển tối đa cần trả về. Phạm vi từ 1 đến 100.
string
Con trỏ từ phản hồi trước dùng để phân trang.
string
mặc định:"finalized"
Mức cam kết dữ liệu.
  • finalized
  • confirmed
number
Slot ngữ cảnh tối thiểu dùng cho yêu cầu (không bắt buộc).
string
mặc định:"desc"
Thứ tự kết quả.
  • asc
  • desc

Ủy quyền

api-key
string
query
bắt buộc

Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong bảng điều khiển.

Nội dung

application/json
jsonrpc
enum<string>
mặc định:2.0
bắt buộc

Phiên bản giao thức JSON-RPC.

Tùy chọn có sẵn:
2.0
Ví dụ:

"2.0"

id
string
mặc định:1
bắt buộc

Mã định danh duy nhất cho yêu cầu.

Ví dụ:

"1"

method
enum<string>
mặc định:getTransfersByAddress
bắt buộc

Tên của phương thức RPC cần gọi.

Tùy chọn có sẵn:
getTransfersByAddress
Ví dụ:

"getTransfersByAddress"

params
(string | object)[]
bắt buộc

Mảng chứa địa chỉ ví bắt buộc và đối tượng cấu hình không bắt buộc.

Required array length: 1 - 2 elements

Địa chỉ ví của chủ sở hữu được mã hóa bằng Base58 cần truy vấn giao dịch chuyển. Truyền địa chỉ chủ sở hữu ví, không phải tài khoản token liên kết (ATA).

Ví dụ:

"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"

Phản hồi

Đã truy xuất thành công các giao dịch chuyển cho địa chỉ đã chỉ định.

jsonrpc
enum<string>

Phiên bản giao thức JSON-RPC.

Tùy chọn có sẵn:
2.0
Ví dụ:

"2.0"

id
string

Mã định danh khớp với yêu cầu.

Ví dụ:

"1"

result
object

Dữ liệu giao dịch chuyển và thông tin phân trang.