> ## 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.
# getTokenAccountsByOwner
> getTokenAccountsByOwner gibt jedes SPL-Token-Konto zurück, das von einer Solana-Wallet gehalten wird, gefiltert nach Mint oder Token-Programm, mit changedSinceSlot inkrementellen Synchronisierungen.
**Neue Funktion**: `getTokenAccountsByOwner` unterstützt jetzt den Parameter `changedSinceSlot` für inkrementelle Updates. Wenn angegeben, gibt die Methode nur Token-Konten zurück, die ab oder nach der angegebenen Slotnummer geändert wurden. Dies ist ideal zum Verfolgen von Token-Bilanzänderungen und Portfolio-Updates.
## Anforderungsparameter
Solana-Wallet-Adresse (pubkey) des Kontoinhabers, um Token-Bestände abzufragen, als Base-58-codierter String.
Spezifische Solana-Token-Mint-Adresse, um nur Konten für ein bestimmtes Token oder NFT abzurufen.
Spezifische Solana-Token-Programm-ID (typischerweise SPL-Token-Programm), die die Token-Konten erstellt hat.
Das Commitment-Level für die Anfrage.
* `confirmed`
* `finalized`
* `processed`
Der minimale Slot, an dem die Anfrage ausgewertet werden kann.
Fordern Sie einen Ausschnitt der Kontodaten an.
Anzahl der zurückzugebenden Bytes.
Byte-Offset, ab dem gelesen werden soll.
Encoding-Format für Kontodaten.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
Geben Sie nur Konten zurück, die ab dieser Slotnummer geändert wurden. Nützlich für inkrementelle Updates.
## OpenAPI
````yaml de/openapi/rpc-http/getTokenAccountsByOwner.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Umfassende Solana Token-Konto-Erkennungs-API zur Abfrage von
SPL-Token-Bilanzen, NFTs und anderen Token-Beständen, die mit einer
beliebigen Wallet-Adresse auf der Solana-Blockchain verbunden sind.
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: getTokenAccountsByOwner
description: >
Rufen Sie alle SPL-Token-Konten ab, die von einer bestimmten
Solana-Wallet-Adresse mit leistungsstarken Filteroptionen gehalten
werden.
Diese essentielle API ermöglicht es Entwicklern, vollständige
Token-Bestände zu entdecken, einschließlich fungibler Token und NFTs,
mit der Möglichkeit, nach bestimmten Token-Mints zu filtern oder auf
Konten zu beschränken, die von bestimmten Token-Programmen erstellt
wurden.
Unterstützt geparste Daten für menschlich lesbare Token-Informationen
einschließlich Salden, Dezimalstellen und Eigentumsstatus.
Kritisch für Wallets, Portfolio-Tracker und DeFi-Anwendungen, die
umfassende Token-Bestandsdaten benötigen.
operationId: getTokenAccountsByOwner
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: Eine eindeutige Kennung für die Anfrage.
example: '1'
default: '1'
method:
type: string
enum:
- getTokenAccountsByOwner
description: Der Name der aufgerufenen RPC-Methode.
example: getTokenAccountsByOwner
default: getTokenAccountsByOwner
params:
type: array
description: >-
Parameter zur Abfrage von Token-Konten, die von einem
bestimmten öffentlichen Schlüssel gehalten werden.
default:
- A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
Solana-Wallet-Adresse (pubkey) des Kontoinhabers zur
Abfrage von Token-Beständen, als Base-58-kodierter
String.
example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- type: object
description: >-
Filterkonfiguration zur Eingrenzung von Token-Konten
nach Mint-Adresse oder Programm-ID.
properties:
mint:
type: string
description: >-
Spezifische Solana-Token-Mint-Adresse, um nur
Konten für einen bestimmten Token oder NFT
abzurufen.
example: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
programId:
type: string
description: >-
Spezifische Solana-Token-Programm-ID
(typischerweise SPL-Token-Programm), die die
Token-Konten erstellt hat.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: Konfigurationsobjekt mit optionalen Feldern.
properties:
commitment:
type: string
description: Das Verpflichtungsniveau für die Anfrage.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: >-
Der minimale Slot, bei dem die Anfrage ausgewertet
werden kann.
example: 1000
dataSlice:
type: object
description: Fordern Sie einen Ausschnitt der Kontodaten an.
properties:
length:
type: integer
description: Anzahl der zurückzugebenden Bytes.
example: 10
offset:
type: integer
description: Byte-Versatz, ab dem das Lesen beginnt.
example: 0
encoding:
type: string
description: Kodierungsformat für Kontodaten.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
changedSinceSlot:
type: integer
description: >-
Geben Sie nur Konten zurück, die an diesem oder
nach diesem Slot geändert wurden. Nützlich für
inkrementelle Updates.
example: 464175999
responses:
'200':
description: Erfolgreich Token-Konten nach Inhaber 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: Kontext- und Kontodetails.
properties:
context:
type: object
description: Kontext der Antwort.
properties:
apiVersion:
type: string
description: API-Version.
example: 2.0.15
slot:
type: integer
description: Slot, in dem die Daten abgerufen wurden.
example: 341197933
value:
type: array
description: Liste der Token-Konten.
items:
type: object
properties:
pubkey:
type: string
description: Konto-Pubkey als Base-58-kodierter String.
example: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
type: object
description: Token-Kontodetails.
properties:
lamports:
type: integer
description: Anzahl der dem Konto zugewiesenen Lamports.
example: 2039280
owner:
type: string
description: >-
Pubkey des Programms, dem dieses Konto
zugewiesen wurde.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
type: object
description: >-
Token-Zustandsdaten, die mit dem Konto
verbunden sind.
properties:
program:
type: string
description: Programmname.
example: spl-token
parsed:
type: object
description: Geparste Token-Daten.
properties:
info:
type: object
description: Token-Kontoinformationen.
properties:
isNative:
type: boolean
description: Zeigt an, ob das Konto native SOL hält.
example: false
mint:
type: string
description: Pubkey des Token-Mints.
example: >-
2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner:
type: string
description: Pubkey des Kontoinhabers.
example: >-
A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state:
type: string
description: Token-Kontostatus.
example: initialized
tokenAmount:
type: object
description: Token-Mengen-Details.
properties:
amount:
type: string
description: Rohsaldo ohne Dezimalstellen.
example: '420000000000000'
decimals:
type: integer
description: Anzahl der Dezimalstellen.
example: 6
uiAmount:
type: number
description: Saldo in benutzerfreundlichem Format.
example: 420000000
uiAmountString:
type: string
description: Saldo als Zeichenkette.
example: '420000000'
space:
type: integer
description: >-
Für das Konto zugewiesener
Speicherplatz.
example: 165
executable:
type: boolean
description: Zeigt an, ob das Konto ein Programm enthält.
example: false
rentEpoch:
type: integer
description: >-
Epoche, in der das Konto das nächste Mal
Miete schuldet.
example: 18446744073709552000
space:
type: integer
description: Datenmenge des Kontos.
example: 165
example:
jsonrpc: '2.0'
id: '1'
result:
context:
apiVersion: 2.0.15
slot: 341197933
value:
- pubkey: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
lamports: 2039280
owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
program: spl-token
parsed:
info:
isNative: false
mint: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state: initialized
tokenAmount:
amount: '420000000000000'
decimals: 6
uiAmount: 420000000
uiAmountString: '420000000'
space: 165
executable: false
rentEpoch: 18446744073709552000
space: 165
'400':
description: >-
Fehlerhafte Anfrage - Ungültige Anfrageparameter 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 - Ratenlimit ü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 - Es ist ein Fehler 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 Timeout - Die Anfrage hat ein 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:
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 Informationen zum 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.
````