> ## 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 gibt die vollständige Solana-Transaktionshistorie für eine Adresse in einem Aufruf zurück — Zeit-, Slot- und Statusfilter, Sortierung und Keyset-Paging.
## Anforderungsparameter
Solana-Kontoadresse, um die Transaktionshistorie abzurufen (Wallet, Token, Programm, NFT usw.).
Detailebene der zurückzugebenden Transaktion.
* `signatures`
* `full`
Sortierreihenfolge für zurückgegebene Transaktionen.
* `asc`
* `desc`
Das Verpflichtungsniveau für die Anfrage. Das `processed`-Commitment wird nicht unterstützt.
* `confirmed`
* `finalized`
Minimaler Kontext-Slot für die Anfrage (optional).
Maximale Anzahl von Transaktionen pro Anfrage. Verwenden Sie 1–1000 für transactionDetails:"signatures" und 1–1000 für transactionDetails:"full".
Paginierungstoken von der vorherigen Antwort, um die nächste Seite der Ergebnisse zu erhalten (Format "slot:position").
Kodierungsformat für Transaktionsdaten (gilt nur, wenn transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Maximale Transaktionsversion, die zurückgegeben werden soll (gilt nur, wenn transactionDetails=full). Auf 1 setzen, um Legacy-, v0- und v1-Transaktionen zu erhalten.
Erweiterte Filter zur Eingrenzung der Transaktionsergebnisse.
Nach Slotnummer filtern.
Größer oder gleich Slotnummer.
Größer als Slotnummer.
Kleiner oder gleich Slotnummer.
Kleiner als Slotnummer.
Nach Blockzeitstempel (Unix-Zeitstempel) filtern.
Größer oder gleich Zeitstempel.
Größer als Zeitstempel.
Kleiner oder gleich Zeitstempel.
Kleiner als Zeitstempel.
Gleich Zeitstempel.
Nach Transaktionssignatur filtern.
Transaktionen mit Signaturen erhalten, die größer oder gleich diesem Wert sind.
Transaktionen nach dieser Signatur erhalten.
Transaktionen mit Signaturen erhalten, die kleiner oder gleich diesem Wert sind.
Transaktionen vor dieser Signatur erhalten.
Nach Transaktionsstatus filtern.
* `succeeded`
* `failed`
* `any`
Transaktionen für verwandte Token-Konten filtern. Steuert, ob Transaktionen eingeschlossen werden, die Token-Konten betreffen, die von der Adresse verwaltet werden.
* `none`
* `balanceChanged`
* `all`
Eingrenzung der Ergebnisse auf Transaktionen, bei denen die abgefragte Adresse an einem Token-Transfer teilgenommen hat, der bestimmten Kriterien entspricht. Alle Felder sind optional und werden mit UND-Semantik kombiniert.
Gegenadresse. Übereinstimmungen mit Übertragungen, deren andere Seite diese Adresse ist.
Übertragungsrichtung relativ zur abgefragten Adresse.
* `in`
* `out`
* `any`
Token-Prägung zum Filtern.
Filter für rohe On-Chain-Betragsbereiche. Alle Felder sind optional und können kombiniert werden.
## OpenAPI
````yaml de/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Erweiterte Solana-Transaktionshistorie API mit leistungsstarken Filter-,
Sortier- und Paginierungsmöglichkeiten zum Abrufen umfassender
Transaktionsdaten für jede Adresse.
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: getTransactionsForAddress
description: >
Erweiterte Transaktionshistorie API, die leistungsstarke Filter-,
Sortier- und Paginierungsmöglichkeiten bietet, um Transaktionsdaten zu
jeder Solana-Adresse abzurufen. Diese erweiterte Methode überwindet die
Einschränkungen von getSignaturesForAddress, indem sie bietet:
- Bidirektionale Sortierung (aufsteigende/absteigende chronologische
Reihenfolge)
- Erweiterte Filterung nach Slot, Zeit, Signatur und Transaktionsstatus
- Unterstützung für Token-Konten (einschließlich Transaktionen für
zugehörige Token-Konten)
- Token-Transfer-Filterung nach Gegenpartei, Richtung, Mint und
Rohbetrag
- Effiziente Keyset-Paginierung mit slotbasierten Schlüsseln
- Möglichkeit, vollständige Transaktionsdetails oder nur Signaturen
zurückzugeben
- Unterstützung für Zeitbereichsabfragen und Statusfilterung
Perfekt zum Erstellen umfassender Wallet-Historien, Analysedashboards,
Audit-Trails und jeder Anwendung, die eine detaillierte
Transaktionsanalyse mit präziser Kontrolle über die Datenabfrage
erfordert.
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: Die JSON-RPC-Protokollversion.
default: '2.0'
id:
type: string
example: '1'
description: Eine eindeutige Kennung für die Anfrage.
default: '1'
method:
type: string
enum:
- getTransactionsForAddress
example: getTransactionsForAddress
description: Der Name der aufzurufenden RPC-Methode.
default: getTransactionsForAddress
params:
type: array
description: >-
Array, das die erforderliche Kontoadresse und optionales
Konfigurationsobjekt enthält.
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: >-
Solana-Kontoadresse, für die die Transaktionshistorie
abgerufen werden soll (Wallet, Token, Programm, NFT
usw.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Erweiterte Abfragekonfiguration zum Filtern, Sortieren
und Paginieren.
properties:
transactionDetails:
type: string
description: Detailgrad der zurückzugebenden Transaktionsdaten.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: >-
Sortierreihenfolge für zurückgegebene
Transaktionen.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
Das Engagement-Level für die Anfrage. Das
`processed` Engagement wird nicht unterstützt.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: Minimaler Kontext-Slot für die Anfrage (optional).
example: 1000
limit:
type: integer
description: >-
Maximale Anzahl von Transaktionen pro Anfrage.
Verwenden Sie 1–1000 für
transactionDetails:"signatures" und 1–1000 für
transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Paginierungstoken aus der vorherigen Antwort, um
die nächste Seite der Ergebnisse zu erhalten
(Format "slot:position").
example: '1053:13'
encoding:
type: string
description: >-
Kodierungsformat für Transaktionsdaten (gilt nur,
wenn transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Maximale Transaktionsversion, die zurückgegeben
werden soll (gilt nur, wenn
transactionDetails=full). Setzen Sie auf 1, um
Legacy-, v0- und v1-Transaktionen zu erhalten.
example: 1
filters:
type: object
description: >-
Erweiterte Filter, um Transaktionsergebnisse
einzugrenzen.
properties:
slot:
type: object
description: Filter nach Slot-Nummer.
properties:
gte:
type: integer
description: Größer als oder gleich der Slot-Nummer.
example: 100
gt:
type: integer
description: Größer als die Slot-Nummer.
example: 100
lte:
type: integer
description: Kleiner oder gleich der Slot-Nummer.
example: 200
lt:
type: integer
description: Kleiner als die Slot-Nummer.
example: 200
additionalProperties: false
blockTime:
type: object
description: >-
Filter nach Blockzeitstempel
(Unix-Zeitstempel).
properties:
gte:
type: integer
description: Größer oder gleich Zeitstempel.
example: 1640995200
gt:
type: integer
description: Größer als Zeitstempel.
example: 1640995200
lte:
type: integer
description: Kleiner oder gleich Zeitstempel.
example: 1641081600
lt:
type: integer
description: Kleiner als Zeitstempel.
example: 1641081600
eq:
type: integer
description: Gleich Zeitstempel.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Filter nach Transaktionssignatur.
properties:
gte:
type: string
description: >-
Erhalten Sie Transaktionen mit Signaturen,
die größer oder gleich diesem Wert sind.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: >-
Erhalten Sie Transaktionen nach dieser
Signatur.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Erhalten Sie Transaktionen mit Signaturen
kleiner oder gleich diesem Wert.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: >-
Erhalten Sie Transaktionen vor dieser
Signatur.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Filter nach Transaktionsstatus.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Filtertransaktionen für zugehörige
Token-Konten. Steuerung, ob Transaktionen
einbezogen werden sollen, die Token-Konten
betreffen, die im Besitz der Adresse sind.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Filter auf Transaktionen, bei denen die
angefragte Adresse an einem Token-Transfer
beteiligt war, der einer Gegenpartei,
Richtung, Mint oder einem Rohbetragsbereich
entspricht.
additionalProperties: false
responses:
'200':
description: Transaktionen für die angegebene Adresse 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: Transaktionsdaten und Paginierungsinformationen.
properties:
data:
type: array
description: Liste von Transaktionsinformationen.
items:
oneOf:
- type: object
description: >-
Signaturlevel-Transaktionsübersicht (wenn
transactionDetails "signatures" ist).
properties:
signature:
type: string
description: >-
Transaktionssignatur als Base-58-codierter
String.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: >-
Der Slot, der den Block mit der Transaktion
enthält.
example: 1054
transactionIndex:
type: integer
description: >-
Der nullbasierte Index der Transaktion
innerhalb ihres Blocks. Nützlich zur
Bestimmung der Transaktionsreihenfolge
innerhalb eines Blocks.
example: 42
err:
oneOf:
- type: object
description: Error if the transaction failed
- type: 'null'
description: >-
Fehler, wenn die Transaktion fehlgeschlagen
ist, oder null, wenn erfolgreich.
example: null
memo:
oneOf:
- type: string
description: Memo associated with the transaction
- type: 'null'
description: >-
Memo, das der Transaktion zugeordnet ist,
oder null, falls keines vorhanden ist.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Estimated production time as Unix
timestamp
- type: 'null'
description: >-
Geschätzte Produktionszeit als
Unix-Zeitstempel (Sekunden seit dem Epoch),
oder null, wenn nicht verfügbar.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Transaction's cluster confirmation
status
- type: 'null'
description: >-
Bestätigungsstatus des Clusters der
Transaktion.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Vollständige Transaktionsdetails mit
Statusmetadaten (wenn transactionDetails "full"
ist).
properties:
slot:
type: integer
description: >-
Der Slot, der den Block mit der Transaktion
enthält.
example: 1054
transactionIndex:
type: integer
description: >-
Der nullbasierte Index der Transaktion
innerhalb ihres Blocks. Nützlich zur
Bestimmung der Transaktionsreihenfolge
innerhalb eines Blocks.
example: 42
transaction:
type: object
description: >-
Kodiertes oder analysiertes
Transaktionsobjekt gemäß der ausgewählten
Kodierung.
meta:
type: object
description: >-
Statusmetadaten der Transaktion — gleiche
Form wie getTransaction, einschließlich err,
fee, preBalances/postBalances,
preTokenBalances/postTokenBalances,
innerInstructions, logMessages und
computeUnitsConsumed.
blockTime:
oneOf:
- type: integer
description: >-
Estimated production time as Unix
timestamp
- type: 'null'
description: >-
Estimated production time as Unix timestamp
(seconds since epoch), or null if not
available.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: Token for retrieving the next page of results
- type: 'null'
description: >-
Paginierungstoken für die nächste Seite, oder null,
wenn keine weiteren Ergebnisse vorhanden sind.
example: '1055:5'
examples:
signaturesResponse:
summary: Response with signature details only
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: Response with full transaction details
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: >-
Fehlerhafte Anfrage - Ungültige Anforderungsparameter oder
fehlerhafte Anfrage.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
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: Unauthorized
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: Too many requests
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: Internal error
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: Service unavailable
id: '1'
'504':
description: >-
Gateway-Zeitüberschreitung - Die Anfrage hat einen Timeout
überschritten.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TokenTransferFilter:
type: object
description: >-
Eingrenzung auf Transaktionen, bei denen die angefragte Adresse an einem
Token-Transfer teilgenommen hat, der bestimmten Kriterien entspricht.
Alle Felder sind optional und werden mit AND-Semantik kombiniert.
properties:
with:
type: string
description: >-
Gegenpartei-Adresse. Entspricht Übertragungen, deren andere Seite
diese Adresse ist.
example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
direction:
type: string
description: Übertragungsrichtung im Verhältnis zur angefragten Adresse.
enum:
- in
- out
- any
default: any
example: in
mint:
type: string
description: Token-Mint zur Filterung.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount:
$ref: '#/components/schemas/TokenTransferAmountFilter'
description: >-
Betragsvergleich mit dem rohen On-Chain-Betrag, nicht mit dem UI-
oder deziadjustierten Betrag.
additionalProperties: false
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 zum Fehler.
id:
type: string
description: Kennung, die der Anfrage entspricht.
example: '1'
TokenTransferAmountFilter:
type: object
description: >-
Rohkettenbereichsfilter. Alle Felder sind optional und können kombiniert
werden.
properties:
gt:
type: number
description: Strikt größer als.
example: 1000000
gte:
type: number
description: Größer als oder gleich.
example: 1000000
lt:
type: number
description: Strikt kleiner als.
example: 5000000
lte:
type: number
description: Kleiner als oder gleich.
example: 5000000
additionalProperties: false
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.
````