> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getTransfersByAddress
> Kueri objek transfer token dan SOL native yang telah diuraikan dan mudah dibaca berdasarkan alamat, dengan filter berdasarkan mint, waktu, jumlah, pihak lawan, dan paginasi.
## 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
Alamat dompet pemilik yang dikodekan dengan Base58 untuk kueri transfer. Masukkan alamat pemilik dompet, bukan akun token terkait (ATA).
Filter berdasarkan alamat pihak lawan. Hanya mengembalikan transfer ke atau dari alamat ini.
Filter berdasarkan arah transfer relatif terhadap alamat yang dikueri.
* `in`
* `out`
* `any`
Alamat mint token. Gunakan So11111111111111111111111111111111111111111 untuk SOL native dan So11111111111111111111111111111111111111112 untuk WSOL.
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`
Filter tambahan untuk jumlah, waktu blok, dan slot.
Filter perbandingan rentang. Semua bidang bersifat opsional dan dapat digabungkan.
Lebih besar dari.
Lebih besar dari atau sama dengan.
Lebih kecil dari.
Lebih kecil dari atau sama dengan.
Filter perbandingan rentang. Semua bidang bersifat opsional dan dapat digabungkan.
Lebih besar dari.
Lebih besar dari atau sama dengan.
Lebih kecil dari.
Lebih kecil dari atau sama dengan.
Filter perbandingan rentang. Semua bidang bersifat opsional dan dapat digabungkan.
Lebih besar dari.
Lebih besar dari atau sama dengan.
Lebih kecil dari.
Lebih kecil dari atau sama dengan.
Jumlah maksimum transfer yang akan dikembalikan. Rentang 1 hingga 100.
Kursor dari respons sebelumnya untuk paginasi.
Tingkat komitmen data.
* `finalized`
* `confirmed`
Slot konteks minimum yang akan digunakan untuk permintaan (opsional).
Urutan hasil.
* `asc`
* `desc`
## OpenAPI
````yaml id/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API riwayat Solana khusus transfer untuk meminta objek transfer token dan
SOL native yang telah diurai dan mudah dibaca berdasarkan alamat, dengan
filter berdasarkan mint, waktu, jumlah, dan pihak lawan. Dirancang untuk
tampilan aktivitas dompet yang akurat, pelacakan pembayaran, dan
rekonsiliasi saldo.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Titik akhir RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Titik akhir RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTransfersByAddress
description: >
Mengembalikan objek transfer token dan SOL native yang telah diurai dan
mudah dibaca untuk
alamat dompet. Metode RPC Helius ini mengembalikan catatan ringkas
khusus transfer
sebagai pengganti payload transaksi lengkap dan dirancang untuk tampilan
aktivitas
dompet yang akurat, pelacakan pembayaran, serta rekonsiliasi saldo.
Anda dapat memfilter riwayat transfer berdasarkan mint, waktu blok,
jumlah, slot,
arah, dan pihak lawan.
operationId: getTransfersByAddress
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
example: '2.0'
description: Versi protokol JSON-RPC.
default: '2.0'
id:
type: string
example: '1'
description: Pengidentifikasi unik untuk permintaan.
default: '1'
method:
type: string
enum:
- getTransfersByAddress
example: getTransfersByAddress
description: Nama metode RPC yang akan dipanggil.
default: getTransfersByAddress
params:
type: array
description: >-
Array yang berisi alamat dompet wajib dan objek konfigurasi
opsional.
minItems: 1
maxItems: 2
default:
- 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
- mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
limit: 50
sortOrder: desc
items:
oneOf:
- type: string
description: >-
Alamat dompet pemilik yang dikodekan dengan Base58
untuk meminta transfer. Masukkan alamat pemilik
dompet, bukan akun token terkait (ATA).
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
- type: object
description: Konfigurasi kueri transfer opsional.
properties:
with:
type: string
description: >-
Filter berdasarkan alamat pihak lawan. Hanya
mengembalikan transfer ke atau dari alamat ini.
example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
direction:
type: string
description: >-
Filter berdasarkan arah transfer relatif terhadap
alamat yang diminta.
enum:
- in
- out
- any
default: any
example: in
mint:
type: string
description: >-
Alamat mint token. Gunakan
So11111111111111111111111111111111111111111 untuk
SOL native dan
So11111111111111111111111111111111111111112 untuk
WSOL.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
solMode:
type: string
description: >-
Mode tampilan SOL/WSOL. merged memperlakukan WSOL
sebagai SOL native dan mengecualikan baris
wrap/unwrap agar riwayat dalam denominasi SOL
lebih mudah direkonsiliasi; separate
mempertahankan WSOL sebagai mint token SPL
terpisah dan menyertakan baris wrap/unwrap.
enum:
- merged
- separate
default: merged
example: merged
filters:
type: object
description: >-
Filter tambahan untuk jumlah, waktu blok, dan
slot.
properties:
amount:
$ref: '#/components/schemas/TransferComparisonFilter'
description: >-
Filter berdasarkan jumlah transfer mentah,
bukan jumlah UI.
blockTime:
$ref: '#/components/schemas/TransferComparisonFilter'
description: >-
Filter berdasarkan stempel waktu blok dalam
detik Unix.
slot:
$ref: '#/components/schemas/TransferComparisonFilter'
description: Filter berdasarkan nomor slot.
additionalProperties: false
limit:
type: integer
description: >-
Jumlah maksimum transfer yang akan dikembalikan.
Rentang 1 hingga 100.
minimum: 1
maximum: 100
default: 100
example: 50
paginationToken:
type: string
description: Kursor dari respons sebelumnya untuk paginasi.
example: 315069220:308:2:1:splTransfer
commitment:
type: string
description: Tingkat komitmen data.
enum:
- finalized
- confirmed
default: finalized
example: finalized
minContextSlot:
type: integer
description: >-
Slot konteks minimum yang akan digunakan untuk
permintaan (opsional).
example: 1000
sortOrder:
type: string
description: Urutan hasil.
enum:
- asc
- desc
default: desc
example: desc
additionalProperties: false
responses:
'200':
description: Berhasil mengambil transfer untuk alamat yang ditentukan.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: Versi protokol JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Pengidentifikasi yang sesuai dengan permintaan.
example: '1'
result:
type: object
description: Data transfer dan informasi paginasi.
properties:
data:
type: array
description: Daftar catatan transfer.
items:
$ref: '#/components/schemas/TokenTransfer'
paginationToken:
oneOf:
- type: string
description: Kursor untuk mengambil halaman hasil berikutnya.
- type: 'null'
description: >-
Kursor untuk halaman berikutnya, atau null jika tidak
ada lagi hasil yang tersedia.
example: 315073428:35:1:0:splTransfer
examples:
transferResponse:
summary: Respons transfer
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- signature: >-
5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
slot: 315073428
blockTime: 1736159420
type: transfer
fromUserAccount: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
toUserAccount: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
fromTokenAccount: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
toTokenAccount: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount: '2500000'
decimals: 6
uiAmount: '2.5'
confirmationStatus: finalized
transactionIdx: 35
instructionIdx: 1
innerInstructionIdx: 0
paginationToken: 315073428:35:1:0:splTransfer
'400':
description: >-
Permintaan Buruk - Parameter permintaan tidak valid atau format
permintaan salah.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Tidak Diotorisasi - Kunci API tidak valid atau tidak tersedia.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Terlalu Banyak Permintaan - Batas laju terlampaui.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Kesalahan Server Internal - Terjadi kesalahan pada server.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Layanan Tidak Tersedia - Layanan tidak tersedia untuk sementara.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Waktu Tunggu Gateway Habis - Waktu tunggu permintaan habis.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TransferComparisonFilter:
type: object
description: >-
Filter perbandingan rentang. Semua bidang bersifat opsional dan dapat
digabungkan.
properties:
gt:
type: number
description: Lebih besar dari.
example: 1000000
gte:
type: number
description: Lebih besar dari atau sama dengan.
example: 1000000
lt:
type: number
description: Kurang dari.
example: 1000000000
lte:
type: number
description: Kurang dari atau sama dengan.
example: 1000000000
additionalProperties: false
TokenTransfer:
type: object
properties:
signature:
type: string
description: Tanda tangan transaksi yang dikodekan dengan Base58.
example: >-
5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
slot:
type: integer
description: Nomor slot yang berisi transaksi.
example: 315073428
blockTime:
type: integer
description: Stempel waktu Unix dalam detik untuk blok.
example: 1736159420
type:
type: string
description: Jenis transfer yang telah diurai.
enum:
- transfer
- mint
- burn
- wrap
- unwrap
- changeOwner
- withdrawWithheldFee
example: transfer
fromUserAccount:
oneOf:
- type: string
- type: 'null'
description: >-
Alamat dompet yang mengirim token, atau null jika tidak ada
pengirim. Bidang ini selalu tersedia.
example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
toUserAccount:
oneOf:
- type: string
- type: 'null'
description: >-
Alamat dompet yang menerima token, atau null jika tidak ada
penerima. Bidang ini selalu tersedia.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
fromTokenAccount:
type: string
description: >-
Akun token sumber. Dihilangkan jika tidak berlaku, seperti pada
transfer SOL native.
example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
toTokenAccount:
type: string
description: >-
Akun token tujuan. Dihilangkan jika tidak berlaku, seperti pada
transfer SOL native.
example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
mint:
type: string
description: >-
Alamat mint token. SOL native menggunakan
So11111111111111111111111111111111111111111; WSOL menggunakan
So11111111111111111111111111111111111111112 jika solMode adalah
separate.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount:
type: string
description: >-
Jumlah transfer mentah sebagai string untuk mempertahankan presisi.
Untuk transfer Token-2022 yang dikenai biaya, ini adalah jumlah yang
diterima oleh tujuan.
example: '2500000'
feeAmount:
type: string
description: >-
Biaya transfer yang ditahan oleh ekstensi biaya transfer Token-2022.
Hanya tersedia pada transfer yang dikenai biaya. Untuk transfer yang
dikenai biaya, sumber didebit sebesar amount ditambah feeAmount, dan
tujuan dikredit sebesar amount.
example: '13450000'
decimals:
type: integer
description: Jumlah desimal token. SOL native menggunakan 9.
example: 6
uiAmount:
type: string
description: Jumlah yang mudah dibaca.
example: '2.5'
feeUiAmount:
type: string
description: >-
Jumlah biaya yang mudah dibaca. Hanya tersedia jika feeAmount
tersedia.
example: '134.5'
confirmationStatus:
type: string
description: Status konfirmasi.
enum:
- finalized
- confirmed
example: finalized
transactionIdx:
type: integer
description: Indeks transaksi di dalam blok.
example: 35
instructionIdx:
type: integer
description: Indeks instruksi di dalam transaksi.
example: 1
innerInstructionIdx:
type: integer
description: >-
Indeks di dalam instruksi internal. Bernilai nol jika transfer
berada di tingkat teratas.
example: 0
required:
- signature
- slot
- blockTime
- type
- fromUserAccount
- toUserAccount
- mint
- amount
- decimals
- uiAmount
- confirmationStatus
- transactionIdx
- instructionIdx
- innerInstructionIdx
additionalProperties: false
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: Versi protokol JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Kode kesalahan.
example: -32602
message:
type: string
description: Pesan kesalahan.
data:
type: object
description: Data tambahan tentang kesalahan.
id:
type: string
description: Pengidentifikasi yang sesuai dengan permintaan.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Kunci API Helius Anda. Anda dapat memperolehnya secara gratis di
[dasbor](https://dashboard.helius.dev/api-keys).
````