> ## 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.
# getSignatureStatuses
> Gibt die Status einer Liste von Signaturen zurück. Jede Signatur muss eine txid sein, die erste Signatur einer Transaktion.
## Anforderungsparameter
Array von Transaktionssignaturen (bis zu 256), als base-58 codierte Strings.
Aktivieren Sie die Suche über den aktuellen Status-Cache hinaus, um ältere historische Transaktionen zu finden.
## OpenAPI
````yaml de/openapi/rpc-http/getSignatureStatuses.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Transaction Confirmation Tracking API zur Überwachung des Status und des
Finalitätsgrades mehrerer Solana-Transaktionen mit Echtzeit-Updates.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Mainnet-RPC-Endpunkt
- url: https://devnet.helius-rpc.com
description: Devnet-RPC-Endpunkt
security: []
paths:
/:
post:
tags:
- RPC
summary: getSignatureStatuses
description: >
Abrufen des Bestätigungsstatus für mehrere Solana-Transaktionen in einer
einzelnen effizienten Batch-Anfrage.
Diese wesentliche Transaktionsverfolgungs-API ermöglicht es Anwendungen,
den Fortschritt von Transaktionen
im Solana-Konsensprozess zu überwachen, von der anfänglichen Einreichung
bis zur endgültigen Bestätigung. Liefert detaillierte
Informationen über den Transaktionsstatus, einschließlich
Verarbeitungslot, Bestätigungsanzahl, Fehlerdetails
und Finalitätsgrad. Kritisch für Wallets, Börsen, Zahlungsabwickler und
jede Anwendung, die
verifizieren muss, wann Transaktionen erfolgreich in der Blockchain
abgewickelt wurden, mit konfigurierbaren
historischen Transaktionssuchoptionen.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Die JSON-RPC-Protokollversion.
example: '2.0'
default: '2.0'
id:
type: string
description: Ein eindeutiger Bezeichner für die Anfrage.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: Der Name der aufzurufenden RPC-Methode.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: >-
Array mit Transaktionssignaturen und optionalem
Konfigurationsobjekt.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: >-
Array von Transaktionssignaturen (bis zu 256) als
Base-58-codierte Strings.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: Konfigurationsoptionen.
properties:
searchTransactionHistory:
type: boolean
description: >-
Aktivieren der Suche über den jüngsten
Status-Cache hinaus, um ältere historische
Transaktionen zu finden.
example: true
responses:
'200':
description: Signaturstatus erfolgreich abgerufen.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: Die JSON-RPC-Protokollversion.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Kennung, die der Anfrage entspricht.
example: '1'
result:
type: object
description: Enthält den Kontext und die Signaturstatuswerte.
properties:
context:
type: object
properties:
slot:
type: integer
description: Slot, in dem die Daten abgefragt wurden.
example: 82
value:
type: array
description: Liste der Transaktionssignaturstatus.
items:
oneOf:
- type: 'null'
description: Null, wenn die Transaktion unbekannt ist.
- type: object
properties:
slot:
type: integer
description: >-
Solana-Blockchain-Slot-Nummer, in dem diese
Transaktion in einen Block aufgenommen
wurde.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
Anzahl der bestätigten Blöcke, seit
diese Transaktion verarbeitet wurde
(null, wenn vollständig finalisiert).
- type: 'null'
description: >-
Null zeigt an, dass die Transaktion
maximale Finalität erreicht hat
(verwurzelt).
example: 48
err:
oneOf:
- type: object
description: >-
Fehlerobjekt, das Details enthält, wenn
die Transaktion während der Ausführung
fehlgeschlagen ist.
- type: 'null'
description: >-
Null zeigt an, dass die Transaktion
erfolgreich ohne Fehler ausgeführt
wurde.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Aktueller Finalitätsstatus der Transaktion
im Solana-Netzwerk (processed → confirmed →
finalized).
example: finalized
examples:
responseExample:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 82
value:
- slot: 48
confirmations: 48
err: null
confirmationStatus: finalized
- null
'400':
description: >-
Fehlerhafte Anfrage - Ungültige Anforderungsparameter oder
fehlerhafte Anfrage.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Ungültige Parameter
id: '1'
'401':
description: Nicht autorisiert - Ungültiger oder fehlender API-Schlüssel.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Nicht autorisiert
id: '1'
'429':
description: Zu viele Anfragen - Ratenbegrenzung überschritten.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Zu viele Anfragen
id: '1'
'500':
description: Interner Serverfehler - Ein Fehler ist auf dem Server aufgetreten.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Interner Fehler
id: '1'
'503':
description: >-
Dienst nicht verfügbar - Der Dienst ist vorübergehend nicht
verfügbar.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Dienst nicht verfügbar
id: '1'
'504':
description: Gateway-Timeout - Die Anfrage hat Zeitüberschreitung verursacht.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway-Timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: Die JSON-RPC-Protokollversion.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Der Fehlercode.
example: -32602
message:
type: string
description: Die Fehlermeldung.
data:
type: object
description: Zusätzliche Daten über den Fehler.
id:
type: string
description: Kennung, die der Anfrage entspricht.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Ihr Helius-API-Schlüssel. Sie können einen kostenlos im
[Dashboard](https://dashboard.helius.dev/api-keys) erhalten.
````