Skip to main content
POST
getTransfersByAddress

Ringkasan

getTransfersByAddress mengembalikan objek transfer yang telah diuraikan dan mudah dibaca untuk pergerakan token dan SOL native yang melibatkan alamat dompet. Gunakan filter untuk mempersempit hasil berdasarkan mint, waktu blok, jumlah, slot, arah, atau pihak lawan. Respons ini dirancang untuk menampilkan aktivitas dompet secara akurat, melacak pembayaran, dan merekonsiliasi saldo tanpa perlu menerapkan ulang penguraian transfer Solana.
Transfer mint dan burn bersifat satu sisi. Mint memiliki fromUserAccount: null dan hanya dapat dikembalikan sebagai transfer masuk bagi penerima. Burn memiliki toUserAccount: null dan hanya dapat dikembalikan sebagai transfer keluar bagi pemilik yang melakukan burn.

Parameter Permintaan

string
wajib
Alamat dompet pemilik yang dikodekan dengan Base58 untuk kueri transfer. Masukkan alamat pemilik dompet, bukan akun token terkait (ATA).
string
Filter berdasarkan alamat pihak lawan. Hanya mengembalikan transfer ke atau dari alamat ini.
string
default:"any"
Filter berdasarkan arah transfer relatif terhadap alamat yang dikueri.
  • in
  • out
  • any
string
Alamat mint token. Gunakan So11111111111111111111111111111111111111111 untuk SOL native dan So11111111111111111111111111111111111111112 untuk WSOL.
string
default:"merged"
Mode tampilan SOL/WSOL. merged memperlakukan WSOL sebagai SOL native dan mengecualikan baris wrap/unwrap agar riwayat berdenominasi SOL lebih mudah direkonsiliasi; separate mempertahankan WSOL sebagai mint token SPL yang berbeda dan menyertakan baris wrap/unwrap.
  • merged
  • separate
object
Filter tambahan untuk jumlah, waktu blok, dan slot.
object
Filter perbandingan rentang. Semua bidang bersifat opsional dan dapat digabungkan.
number
Lebih besar dari.
number
Lebih besar dari atau sama dengan.
number
Lebih kecil dari.
number
Lebih kecil dari atau sama dengan.
object
Filter perbandingan rentang. Semua bidang bersifat opsional dan dapat digabungkan.
number
Lebih besar dari.
number
Lebih besar dari atau sama dengan.
number
Lebih kecil dari.
number
Lebih kecil dari atau sama dengan.
object
Filter perbandingan rentang. Semua bidang bersifat opsional dan dapat digabungkan.
number
Lebih besar dari.
number
Lebih besar dari atau sama dengan.
number
Lebih kecil dari.
number
Lebih kecil dari atau sama dengan.
number
default:"100"
Jumlah maksimum transfer yang akan dikembalikan. Rentang 1 hingga 100.
string
Kursor dari respons sebelumnya untuk paginasi.
string
default:"finalized"
Tingkat komitmen data.
  • finalized
  • confirmed
number
Slot konteks minimum yang akan digunakan untuk permintaan (opsional).
string
default:"desc"
Urutan hasil.
  • asc
  • desc

Otorisasi

api-key
string
query
wajib

Kunci API Helius Anda. Anda dapat memperolehnya secara gratis di dasbor.

Body

application/json
jsonrpc
enum<string>
default:2.0
wajib

Versi protokol JSON-RPC.

Opsi yang tersedia:
2.0
Contoh:

"2.0"

id
string
default:1
wajib

Pengidentifikasi unik untuk permintaan.

Contoh:

"1"

method
enum<string>
default:getTransfersByAddress
wajib

Nama metode RPC yang akan dipanggil.

Opsi yang tersedia:
getTransfersByAddress
Contoh:

"getTransfersByAddress"

params
(string | object)[]
wajib

Array yang berisi alamat dompet wajib dan objek konfigurasi opsional.

Required array length: 1 - 2 elements

Alamat dompet pemilik yang dikodekan dengan Base58 untuk meminta transfer. Masukkan alamat pemilik dompet, bukan akun token terkait (ATA).

Contoh:

"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"

Respons

Berhasil mengambil transfer untuk alamat yang ditentukan.

jsonrpc
enum<string>

Versi protokol JSON-RPC.

Opsi yang tersedia:
2.0
Contoh:

"2.0"

id
string

Pengidentifikasi yang sesuai dengan permintaan.

Contoh:

"1"

result
object

Data transfer dan informasi paginasi.