> ## 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.
# getSignaturesForAddress
> getSignaturesForAddress mengembalikan tanda tangan transaksi terkonfirmasi yang menyertakan alamat Solana dalam accountKeys, dengan urutan mundur dari blok terbaru.
Untuk pemfilteran lanjutan, pengurutan, dan riwayat akun token, gunakan [`getTransactionsForAddress`](/docs/id/rpc/gettransactionsforaddress). Perhatikan bahwa `getSignaturesForAddress` tidak menyertakan transaksi yang melibatkan akun token terkait.
## Parameter Permintaan
Alamat akun Solana yang riwayat transaksinya akan diambil (dompet, token, program, NFT, dan sebagainya).
Tingkat komitmen untuk permintaan. Komitmen `processed` tidak didukung.
* `confirmed`
* `finalized`
Slot minimum tempat permintaan dapat dievaluasi.
Jumlah maksimum tanda tangan transaksi yang akan dikembalikan dalam satu permintaan (1-1.000).
Parameter paginasi untuk mendapatkan transaksi sebelum tanda tangan ini (lebih awal dalam urutan waktu).
Dapatkan transaksi hingga tanda tangan ini tercapai, berguna untuk rentang waktu tertentu.
## OpenAPI
````yaml id/openapi/rpc-http/getSignaturesForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API riwayat transaksi Solana yang komprehensif untuk mengambil dan
menganalisis aktivitas blockchain historis yang terkait dengan alamat dompet
atau program 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: getSignaturesForAddress
description: >
Ambil tanda tangan transaksi untuk aktivitas yang melibatkan alamat
Solana tertentu dengan paginasi yang canggih.
API penting ini menyediakan riwayat transaksi untuk alamat dompet,
token, program, atau NFT Solana apa pun,
serta mengembalikan tanda tangan transaksi secara kronologis beserta
status, waktu, dan hasil eksekusinya.
Sangat cocok untuk membuat riwayat transaksi dompet, memantau aktivitas
program, menganalisis alamat,
dan aplikasi apa pun yang perlu melacak operasi historis di blockchain
Solana.
Mendukung paginasi fleksibel untuk mengakses riwayat transaksi lengkap.
operationId: getSignaturesForAddress
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:
- getSignaturesForAddress
example: getSignaturesForAddress
description: Nama metode RPC yang akan dipanggil.
default: getSignaturesForAddress
params:
type: array
description: >-
Larik yang berisi alamat akun wajib dan objek konfigurasi
opsional.
default:
- Vote111111111111111111111111111111111111111
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 menyesuaikan
pengambilan riwayat transaksi.
properties:
commitment:
type: string
description: >-
Tingkat komitmen untuk permintaan. Komitmen
`processed` tidak didukung.
enum:
- confirmed
- finalized
example: finalized
minContextSlot:
type: integer
description: Slot minimum tempat permintaan dapat dievaluasi.
example: 1000
limit:
type: integer
description: >-
Jumlah maksimum tanda tangan transaksi yang akan
dikembalikan dalam satu permintaan (1-1.000).
example: 1000
before:
type: string
description: >-
Parameter paginasi untuk mendapatkan transaksi
sebelum tanda tangan ini (lebih awal secara
waktu).
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
until:
type: string
description: >-
Dapatkan transaksi hingga tanda tangan ini
tercapai, berguna untuk rentang waktu tertentu.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
responses:
'200':
description: Berhasil mengambil tanda tangan 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: array
description: Daftar informasi tanda tangan transaksi.
items:
type: object
description: Detail untuk setiap tanda tangan transaksi.
properties:
signature:
type: string
description: >-
Tanda tangan transaksi sebagai string yang dikodekan
dalam base-58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: Slot yang berisi blok dengan transaksi tersebut.
example: 114
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: null
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: Status konfirmasi klaster transaksi
- type: 'null'
description: Status konfirmasi klaster transaksi.
example: finalized
examples:
response:
value:
jsonrpc: '2.0'
id: 1
result:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 114
err: null
memo: null
blockTime: null
confirmationStatus: finalized
application/json; schema=examples/request:
example:
jsonrpc: '2.0'
id: 1
method: getSignaturesForAddress
params:
- Vote111111111111111111111111111111111111111
- limit: 1
'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: Batas Waktu Gateway - Waktu permintaan habis.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Waktu gateway habis
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
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).
````