> ## 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.
# getTransactionsForAddress
> getTransactionsForAddress mengembalikan riwayat transaksi Solana lengkap untuk suatu alamat dalam satu panggilan — dengan filter waktu, slot, dan status, pengurutan, serta paginasi keyset.
## Parameter Permintaan
Alamat akun Solana yang riwayat transaksinya akan diambil (dompet, token, program, NFT, dan sebagainya).
Tingkat detail transaksi yang akan dikembalikan.
* `signatures`
* `full`
Urutan pengurutan untuk transaksi yang dikembalikan.
* `asc`
* `desc`
Tingkat commitment untuk permintaan. Commitment `processed` tidak didukung.
* `confirmed`
* `finalized`
Slot konteks minimum yang akan digunakan untuk permintaan (opsional).
Jumlah maksimum transaksi per permintaan. Gunakan 1–1000 untuk transactionDetails:"signatures" dan 1–1000 untuk transactionDetails:"full".
Token paginasi dari respons sebelumnya untuk mendapatkan halaman hasil berikutnya (format "slot:position").
Format pengodean untuk data transaksi (hanya berlaku jika transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Versi transaksi maksimum yang akan dikembalikan (hanya berlaku jika transactionDetails=full). Atur ke 1 untuk menerima transaksi legacy, v0, dan v1.
Filter lanjutan untuk mempersempit hasil transaksi.
Filter berdasarkan nomor slot.
Lebih besar dari atau sama dengan nomor slot.
Lebih besar dari nomor slot.
Lebih kecil dari atau sama dengan nomor slot.
Lebih kecil dari nomor slot.
Filter berdasarkan stempel waktu blok (stempel waktu Unix).
Lebih besar dari atau sama dengan stempel waktu.
Lebih besar dari stempel waktu.
Lebih kecil dari atau sama dengan stempel waktu.
Lebih kecil dari stempel waktu.
Sama dengan stempel waktu.
Filter berdasarkan tanda tangan transaksi.
Dapatkan transaksi dengan tanda tangan yang lebih besar dari atau sama dengan nilai ini.
Dapatkan transaksi setelah tanda tangan ini.
Dapatkan transaksi dengan tanda tangan yang lebih kecil dari atau sama dengan nilai ini.
Dapatkan transaksi sebelum tanda tangan ini.
Filter berdasarkan status transaksi.
* `succeeded`
* `failed`
* `any`
Filter transaksi untuk akun token terkait. Mengontrol apakah transaksi yang melibatkan akun token milik alamat tersebut disertakan.
* `none`
* `balanceChanged`
* `all`
Mempersempit hasil ke transaksi saat alamat yang dikueri berpartisipasi dalam transfer token yang cocok dengan kriteria tertentu. Semua bidang bersifat opsional dan digabungkan dengan semantik AND.
Alamat pihak lawan. Mencocokkan transfer yang pihak lainnya adalah alamat ini.
Arah transfer relatif terhadap alamat yang dikueri.
* `in`
* `out`
* `any`
Mint token yang akan digunakan sebagai filter.
Filter rentang jumlah mentah on-chain. Semua bidang bersifat opsional dan dapat digabungkan.
## OpenAPI
````yaml id/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API riwayat transaksi Solana tingkat lanjut dengan kemampuan pemfilteran,
pengurutan, dan paginasi yang canggih untuk mengambil data transaksi lengkap
bagi alamat apa pun.
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: getTransactionsForAddress
description: >
API riwayat transaksi yang disempurnakan dan menyediakan kemampuan
pemfilteran, pengurutan, serta paginasi yang canggih
untuk mengambil data transaksi yang terkait dengan alamat Solana apa
pun. Metode tingkat lanjut ini mengatasi
keterbatasan getSignaturesForAddress dengan menawarkan:
- Pengurutan dua arah (urutan kronologis menaik/menurun)
- Pemfilteran tingkat lanjut berdasarkan slot, waktu, tanda tangan, dan
status transaksi
- Dukungan akun token (menyertakan transaksi untuk akun token terkait)
- Pemfilteran transfer token berdasarkan pihak lawan, arah, mint, dan
jumlah mentah
- Paginasi keyset yang efisien menggunakan kunci berbasis slot
- Opsi untuk mengembalikan detail transaksi lengkap atau hanya tanda
tangan
- Dukungan untuk kueri rentang waktu dan pemfilteran status
Sangat cocok untuk membuat riwayat dompet yang lengkap, dasbor analitik,
jejak audit,
dan aplikasi apa pun yang memerlukan analisis transaksi terperinci
dengan kontrol presisi atas pengambilan data.
operationId: getTransactionsForAddress
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:
- getTransactionsForAddress
example: getTransactionsForAddress
description: Nama metode RPC yang akan dipanggil.
default: getTransactionsForAddress
params:
type: array
description: >-
Larik yang berisi alamat akun wajib dan objek konfigurasi
opsional.
minItems: 1
maxItems: 2
default:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
items:
oneOf:
- type: string
description: >-
Alamat akun Solana yang riwayat transaksinya akan
diambil (dompet, token, program, NFT, dan sebagainya).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Konfigurasi kueri tingkat lanjut untuk pemfilteran,
pengurutan, dan paginasi.
properties:
transactionDetails:
type: string
description: Tingkat detail transaksi yang akan dikembalikan.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: >-
Urutan pengurutan untuk transaksi yang
dikembalikan.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
Tingkat komitmen untuk permintaan. Komitmen
`processed` tidak didukung.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: >-
Slot konteks minimum yang akan digunakan untuk
permintaan (opsional).
example: 1000
limit:
type: integer
description: >-
Jumlah maksimum transaksi per permintaan. Gunakan
1–1000 untuk transactionDetails:"signatures" dan
1–1000 untuk transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Token paginasi dari respons sebelumnya untuk
mendapatkan halaman hasil berikutnya (format
"slot:position").
example: '1053:13'
encoding:
type: string
description: >-
Format pengodean untuk data transaksi (hanya
berlaku jika transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Versi transaksi maksimum yang akan dikembalikan
(hanya berlaku jika transactionDetails=full). Atur
ke 1 untuk menerima transaksi lama, v0, dan v1.
example: 1
filters:
type: object
description: >-
Filter tingkat lanjut untuk mempersempit hasil
transaksi.
properties:
slot:
type: object
description: Filter berdasarkan nomor slot.
properties:
gte:
type: integer
description: >-
Lebih besar dari atau sama dengan nomor
slot.
example: 100
gt:
type: integer
description: Lebih besar dari nomor slot.
example: 100
lte:
type: integer
description: >-
Lebih kecil dari atau sama dengan nomor
slot.
example: 200
lt:
type: integer
description: Lebih kecil dari nomor slot.
example: 200
additionalProperties: false
blockTime:
type: object
description: >-
Filter berdasarkan stempel waktu blok (stempel
waktu Unix).
properties:
gte:
type: integer
description: >-
Lebih besar dari atau sama dengan stempel
waktu.
example: 1640995200
gt:
type: integer
description: Lebih besar dari stempel waktu.
example: 1640995200
lte:
type: integer
description: >-
Lebih kecil dari atau sama dengan stempel
waktu.
example: 1641081600
lt:
type: integer
description: Lebih kecil dari stempel waktu.
example: 1641081600
eq:
type: integer
description: Sama dengan stempel waktu.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Filter berdasarkan tanda tangan transaksi.
properties:
gte:
type: string
description: >-
Dapatkan transaksi dengan tanda tangan
yang lebih besar dari atau sama dengan
nilai ini.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: >-
Dapatkan transaksi setelah tanda tangan
ini.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Dapatkan transaksi dengan tanda tangan
yang lebih kecil dari atau sama dengan
nilai ini.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: >-
Dapatkan transaksi sebelum tanda tangan
ini.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Filter berdasarkan status transaksi.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Filter transaksi untuk akun token terkait.
Mengontrol apakah transaksi yang melibatkan
akun token milik alamat tersebut disertakan.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Filter ke transaksi tempat alamat yang dikueri
berpartisipasi dalam transfer token yang cocok
dengan pihak lawan, arah, mint, atau rentang
jumlah mentah.
additionalProperties: false
responses:
'200':
description: Berhasil mengambil transaksi 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 cocok dengan permintaan.
example: '1'
result:
type: object
description: Data transaksi dan informasi paginasi.
properties:
data:
type: array
description: Daftar informasi transaksi.
items:
oneOf:
- type: object
description: >-
Ringkasan transaksi pada tingkat tanda tangan
(ketika transactionDetails adalah "signatures").
properties:
signature:
type: string
description: >-
Tanda tangan transaksi sebagai string yang
dikodekan dengan base-58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: >-
Slot yang berisi blok dengan transaksi
tersebut.
example: 1054
transactionIndex:
type: integer
description: >-
Indeks berbasis nol untuk transaksi di dalam
bloknya. Berguna untuk menentukan urutan
transaksi di dalam blok.
example: 42
err:
oneOf:
- type: object
description: Kesalahan jika transaksi gagal
- type: 'null'
description: >-
Kesalahan jika transaksi gagal, atau null
jika berhasil.
example: null
memo:
oneOf:
- type: string
description: Memo yang terkait dengan transaksi
- type: 'null'
description: >-
Memo yang terkait dengan transaksi, atau
null jika tidak ada.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Perkiraan waktu produksi sebagai stempel
waktu Unix
- type: 'null'
description: >-
Perkiraan waktu produksi sebagai stempel
waktu Unix (detik sejak epoch), atau null
jika tidak tersedia.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: Status konfirmasi klaster transaksi
- type: 'null'
description: Status konfirmasi klaster transaksi.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Transaksi lengkap dengan metadata status (ketika
transactionDetails adalah "full").
properties:
slot:
type: integer
description: >-
Slot yang berisi blok dengan transaksi
tersebut.
example: 1054
transactionIndex:
type: integer
description: >-
Indeks berbasis nol untuk transaksi di dalam
bloknya. Berguna untuk menentukan urutan
transaksi di dalam blok.
example: 42
transaction:
type: object
description: >-
Objek transaksi yang dikodekan atau diurai
sesuai pengodean yang dipilih.
meta:
type: object
description: >-
Metadata status transaksi — memiliki
struktur yang sama dengan getTransaction,
termasuk err, fee, preBalances/postBalances,
preTokenBalances/postTokenBalances,
innerInstructions, logMessages, dan
computeUnitsConsumed.
blockTime:
oneOf:
- type: integer
description: >-
Perkiraan waktu produksi sebagai stempel
waktu Unix
- type: 'null'
description: >-
Perkiraan waktu produksi sebagai stempel
waktu Unix (detik sejak epoch), atau null
jika tidak tersedia.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: Token untuk mengambil halaman hasil berikutnya
- type: 'null'
description: >-
Token paginasi untuk halaman berikutnya, atau null
jika tidak ada hasil lagi.
example: '1055:5'
examples:
signaturesResponse:
summary: Respons yang hanya berisi detail tanda tangan
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1054
transactionIndex: 42
err: null
memo: null
blockTime: 1641038400
confirmationStatus: finalized
- signature: >-
kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1055
transactionIndex: 15
err: null
memo: null
blockTime: 1641038460
confirmationStatus: finalized
paginationToken: '1055:5'
fullResponse:
summary: Respons dengan detail transaksi lengkap
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- slot: 1054
transactionIndex: 42
transaction:
signatures:
- >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
message:
accountKeys:
- ...
- ...
instructions:
- ...
meta:
err: null
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
preTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '1500000'
decimals: 6
uiAmount: 1.5
uiAmountString: '1.5'
postTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '500000'
decimals: 6
uiAmount: 0.5
uiAmountString: '0.5'
logMessages:
- ...
computeUnitsConsumed: 2100
blockTime: 1641038400
paginationToken: '1055:5'
'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: Parameter tidak valid
id: '1'
'401':
description: Tidak Diotorisasi - Kunci API tidak valid atau tidak ada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Tidak diotorisasi
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: Terlalu banyak permintaan
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: Kesalahan internal
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: Layanan tidak tersedia
id: '1'
'504':
description: Waktu Tunggu Gateway Habis - Waktu permintaan habis.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Waktu tunggu gateway habis
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TokenTransferFilter:
type: object
description: >-
Mempersempit hasil ke transaksi tempat alamat yang dikueri
berpartisipasi dalam transfer token yang cocok dengan kriteria tertentu.
Semua bidang bersifat opsional dan digabungkan dengan semantik AND.
properties:
with:
type: string
description: >-
Alamat pihak lawan. Mencocokkan transfer yang pihak lainnya adalah
alamat ini.
example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
direction:
type: string
description: Arah transfer relatif terhadap alamat yang dikueri.
enum:
- in
- out
- any
default: any
example: in
mint:
type: string
description: Mint token yang akan difilter.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount:
$ref: '#/components/schemas/TokenTransferAmountFilter'
description: >-
Perbandingan jumlah menggunakan jumlah mentah on-chain, bukan jumlah
UI atau jumlah yang disesuaikan dengan desimal.
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 cocok dengan permintaan.
example: '1'
TokenTransferAmountFilter:
type: object
description: >-
Filter rentang jumlah mentah on-chain. Semua bidang bersifat opsional
dan dapat digabungkan.
properties:
gt:
type: number
description: Benar-benar lebih besar dari.
example: 1000000
gte:
type: number
description: Lebih besar dari atau sama dengan.
example: 1000000
lt:
type: number
description: Benar-benar lebih kecil dari.
example: 5000000
lte:
type: number
description: Lebih kecil dari atau sama dengan.
example: 5000000
additionalProperties: false
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).
````