> ## 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.
# getTokenAccountsByOwnerV2
> getTokenAccountsByOwnerV2 ist eine verbesserte Version von getTokenAccountsByOwner mit Cursor-Paginierung und changedSinceSlot-Updates für große Solana-Token-Portfolios.
## Übersicht
`getTokenAccountsByOwnerV2` ist eine verbesserte Version der standardmäßigen `getTokenAccountsByOwner` Methode, die speziell für die effiziente Abfrage von Token-Portfolios und die Verwaltung von Wallets mit umfangreichen Token-Beständen entwickelt wurde. Diese Methode führt eine cursor-basierte Paginierung und inkrementelle Aktualisierungsfunktionen ein.
**Neue Funktionen in V2:**
* **Cursor-basierte Paginierung**: Begrenzungen von 1 bis 10.000 Token-Konten pro Anfrage konfigurieren
* **Inkrementelle Updates**: Verwenden Sie `changedSinceSlot`, um nur kürzlich geänderte Token-Konten abzurufen
* **Portfolio-Skalierbarkeit**: Verwaltung von Wallets mit Tausenden von Token-Konten effizient
* **Abwärtskompatibilität**: Unterstützt alle bestehenden `getTokenAccountsByOwner` Parameter und Filter
* **Optionales `withContext`**: `true` fügt `slot` und `apiVersion` unter `result.context` hinzu; auslassen oder `false` und sie werden nicht einbezogen
**Filteranforderung**: Sie müssen entweder einen `mint` (spezifisches Token) oder `programId` (SPL-Token- oder Token-2022-Programm) in Ihrer Abfrage angeben. Die Abfrage aller Token-Typen für einen Besitzer ohne Filter wird nicht unterstützt.
## Wichtige Vorteile
Verwaltung von Wallets mit Tausenden von Token-Konten ohne Zeitüberschreitungen oder Speicherprobleme
Überwachen Sie Portfoliowechsel in Echtzeit mit `changedSinceSlot` für inkrementelle Updates
## `withContext` (optional)
Boolescher Wert im Konfigurationsobjekt (`params[2]`). Nur die Form von `result` ändert sich, nicht jedoch Filter, Begrenzungen oder Paginierung. Weggelassen oder `false`: `result.value` ist das Token-Konto **Array**. `true`: `result.context` plus `result.value` als **Objekt** (`accounts`, `paginationKey`). Wenn Sie beide verwalten, verzweigen Sie sich auf `Array.isArray(result.value)`.
```json theme={"system"}
// Omitted or false
{ "jsonrpc": "2.0", "id": "1", "result": { "value": [], "paginationKey": null } }
// true
{ "jsonrpc": "2.0", "id": "1", "result": {
"context": { "slot": 411895550, "apiVersion": "3.1.9" },
"value": { "accounts": [], "paginationKey": null }
}}
```
## Beste Praktiken für die Paginierung
**Wichtiges Paginierungsverhalten**: Das Ende der Paginierung wird nur angezeigt, wenn **keine Token-Konten zurückgegeben werden**. Die API kann aufgrund von Filterung weniger Konten als Ihr Limit zurückgeben - fahren Sie immer mit der Paginierung fort, bis `paginationKey` `null` ist.
### Grundlegende Portfolioabfrage
```typescript theme={"system"}
// Get all SPL Token accounts for a wallet
let allTokenAccounts = [];
let paginationKey = null;
do {
const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getTokenAccountsByOwnerV2',
params: [
"9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM", // wallet address
{ "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
{
encoding: 'jsonParsed',
limit: 1000,
...(paginationKey && { paginationKey })
}
]
})
});
const data = await response.json();
allTokenAccounts.push(...data.result.value);
paginationKey = data.result.paginationKey;
} while (paginationKey);
console.log(`Total token accounts: ${allTokenAccounts.length}`);
```
### Inkrementelle Portfolio-Updates
```typescript theme={"system"}
// Get only token accounts modified since a specific slot
const portfolioUpdates = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getTokenAccountsByOwnerV2',
params: [
walletAddress,
{ "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
{
encoding: 'jsonParsed',
limit: 1000,
changedSinceSlot: lastUpdateSlot // Only get recent changes
}
]
})
});
```
## Unterstützung des Token-Programms
**Token-2022-Unterstützung**: Verwenden Sie `TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb` als `programId`, um Token-2022-Konten mit Erweiterungen wie Überweisungsgebühren, verzinslichen Token und mehr abzufragen.
```typescript theme={"system"}
// Query Token-2022 accounts (supports token extensions)
const token2022Response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getTokenAccountsByOwnerV2',
params: [
walletAddress,
{ "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb" }, // Token-2022
{ encoding: 'jsonParsed', limit: 1000 }
]
})
});
```
## Migration von getTokenAccountsByOwner
Die Migration ist einfach - fügen Sie einfach Paginierungsparameter zu Ihren bestehenden Anfragen hinzu:
```diff theme={"system"}
{
"jsonrpc": "2.0",
"id": "1",
- "method": "getTokenAccountsByOwner",
+ "method": "getTokenAccountsByOwnerV2",
"params": [
"9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
{ "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
{
"encoding": "jsonParsed",
+ "limit": 1000
}
]
}
```
## Verwandte Methoden
Ursprüngliche Methode ohne Paginierung
V2-Methode für Programmkontoabfragen
## Anforderungsparameter
Solana-Wallet-Adresse (pubkey) des Konto-Eigentümers, um Token-Bestände abzufragen, als base-58 kodierter 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.
Die Zusicherungsebene für die Anfrage.
* `confirmed`
* `finalized`
* `processed`
Der Mindestslot, bei dem die Anfrage ausgewertet werden kann.
Wenn `true`, wird `result.context` (Snapshot-Metadaten: `slot`, `apiVersion`) zurückgegeben und verschachtelt
`accounts` und `paginationKey` unter `result.value` als ein Objekt. Wenn `false`
oder weggelassen, ist `result.value` das Token-Konto-Array für diese Seite, mit `paginationKey`
auf `result`. Gleiche Filter und Begrenzungen gelten.
Einen Abschnitt der Kontodaten anfordern.
Anzahl der zurückzugebenden Bytes.
Byte-Versatz, ab dem mit dem Lesen begonnen werden soll.
Codierungsformat für Kontodaten.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
Maximale Anzahl von Token-Konten, die pro Anfrage zurückgegeben werden (1-10.000).
Base-58-kodierter Paginierungs-Cursor zum Abrufen nachfolgender Seiten. Verwenden Sie den paginationKey aus der vorherigen Antwort.
Nur Token-Konten zurückgeben, die bei oder nach dieser Slot-Nummer geändert wurden. Nützlich für inkrementelle Portfolio-Updates.
## OpenAPI
````yaml de/openapi/rpc-http/getTokenAccountsByOwnerV2.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Erweiterte API zur Entdeckung von Solana-Token-Konten mit zusätzlichen
Funktionen wie cursorbasierter Paginierung und Unterstützung für
changedSinceSlot zum effizienten Abrufen von SPL-Token-Guthaben, NFTs und
anderen Token-Beständen, die mit einer beliebigen Wallet-Adresse verknüpft
sind. Unterstützt inkrementelle Aktualisierungen durch slotbasierte
Filterung.
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: getTokenAccountsByOwnerV2
description: >
Erweiterte Version von getTokenAccountsByOwner mit zusätzlichen
Funktionen wie cursorbasierter Paginierung
und Unterstützung von changedSinceSlot für das effiziente Abrufen großer
Mengen von SPL-Token-Konten, die im Besitz einer
spezifischen Wallet-Adresse sind. Ermöglicht skalierbare
Portfolioabfragen mit konfigurierbaren Seitengrößen von bis zu 10.000
Konten pro Anfrage. Der Parameter changedSinceSlot ermöglicht das
Abrufen nur der Token-Konten, die
seit einem bestimmten Blockchain-Slot geändert wurden. Ideal für
Echtzeit-Portfoliotracking und Wallet-Saldo
Synchronisation. Wesentlich für Wallets, Portfolio-Tracker,
DeFi-Anwendungen und jeden Dienst,
der umfassende Token-Bestandsdaten für Benutzer mit umfangreichen
Token-Portfolios benötigt.
Hinweis: Das Ende der Paginierung wird nur angezeigt, wenn keine
Token-Konten zurückgegeben werden. Die API kann weniger
Konten als das Limit zurückgeben aufgrund von Filterung - setzen Sie die
Paginierung fort, bis der paginationKey null ist.
**withContext**: Optionaler boolescher Wert im Konfigurationsobjekt
(neben Encoding, Limit und so weiter). Wenn
`withContext` `true` ist, gibt der RPC die standardmäßige Solana
umschlossene Form zurück: `result.context` (Snapshot
Metadaten, einschließlich `slot` und normalerweise `apiVersion`) und
`result.value` als ein Objekt, das `accounts`
und `paginationKey` enthält. Wenn `withContext` `false` oder ausgelassen
ist, ist die Kontoliste
`result.value` als Array (wie bei klassischem
`getTokenAccountsByOwner`), mit `paginationKey`
auf `result`. Filter, Grenzen und Paginierungsverhalten sind
unverändert; nur die JSON-Form
von `result` unterscheidet sich.
operationId: getTokenAccountsByOwnerV2
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:
- getTokenAccountsByOwnerV2
description: Der Name der aufzurufenden RPC-Methode.
example: getTokenAccountsByOwnerV2
default: getTokenAccountsByOwnerV2
params:
type: array
description: >-
Parameter zum Abfragen paginierter Token-Konten, die sich im
Besitz eines bestimmten öffentlichen Schlüssels befinden.
default:
- A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
limit: 1000
items:
oneOf:
- type: string
description: >-
Solana-Wallet-Adresse (Pubkey) des Kontoinhabers, um
Token-Bestände abzufragen, als base-58 codierter
String.
example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- type: object
description: >-
Filterkonfiguration, um die Token-Konten nach
Mint-Adresse oder Programm-ID einzugrenzen.
properties:
mint:
type: string
description: >-
Spezifische Solana-Token-Mint-Adresse, um nur
Konten für ein bestimmtes 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: >-
Erweitertes Konfigurationsobjekt mit Unterstützung für
Paginierung und optionalen Feldern.
properties:
commitment:
type: string
description: Das Engagementniveau für die Anfrage.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: >-
Der Mindestspeicherplatz, bei dem die Anfrage
bewertet werden kann.
example: 1000
withContext:
type: boolean
description: >
Wenn `true`, gibt `result.context` zurück
(Snapshot-Metadaten: `slot`, `apiVersion`) und
verschachtelt
`accounts` und `paginationKey` unter
`result.value` als Objekt. Wenn `false`
oder ausgelassen, ist `result.value` das
Token-Konto-Array für diese Seite, mit
`paginationKey`
auf `result`. Dieselben Filter und Grenzen gelten.
example: true
dataSlice:
type: object
description: Eine Scheibe der Kontodaten anfordern.
properties:
length:
type: integer
description: Anzahl der zurückzugebenden Bytes.
example: 10
offset:
type: integer
description: Byte-Offset, ab dem das Lesen beginnt.
example: 0
encoding:
type: string
description: Kodierungsformat für Kontodaten.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
limit:
type: integer
description: >-
Maximale Anzahl von Token-Konten, die pro Anfrage
zurückgegeben werden (1-10.000).
minimum: 1
maximum: 10000
example: 1000
paginationKey:
type: string
description: >-
Base-58 codierter Paginierungscursor zum Abrufen
nachfolgender Seiten. Verwenden Sie den
paginationKey aus der vorherigen Antwort.
example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
changedSinceSlot:
type: integer
description: >-
Gibt nur die Token-Konten zurück, die bei oder
nach dieser Slot-Nummer geändert wurden. Nützlich
für inkrementelle Portfolioaktualisierungen.
example: 12345678
responses:
'200':
description: Erfolgreich paginierte 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: Bezeichner, der mit der Anfrage übereinstimmt.
example: '1'
result:
oneOf:
- $ref: >-
#/components/schemas/TokenAccountsByOwnerV2ResultDirect
title: ohne withContext
- type: object
title: mit withContext
description: >-
Eingewickeltes Ergebnis, wenn `withContext` in den
Anforderungsoptionen `true` ist.
required:
- context
- value
properties:
context:
type: object
description: >-
Snapshot-Metadaten für die Knotenantwort
(Slot-Konsistenz, Debugging).
properties:
slot:
type: integer
description: >-
Slot, bei dem der Knoten diese Antwort
erstellt hat.
example: 341197933
apiVersion:
type: string
description: RPC-API-Version, wenn verfügbar.
example: 2.0.15
value:
$ref: '#/components/schemas/TokenAccountsByOwnerV2Page'
example:
jsonrpc: '2.0'
id: '1'
result:
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
paginationKey: 8WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
'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 - Rate-Limit überschritten.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Zu viele Abfragen
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-Zeitüberschreitung - Die Anfrage hat ein Zeitlimit
überschritten.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway-Zeitüberschreitung
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TokenAccountsByOwnerV2ResultDirect:
type: object
description: >-
Paginierte Token-Konten, wenn `withContext` falsch oder ausgelassen ist.
Entspricht der bekannten Form, bei der die Kontoliste `result.value` als
Array ist (nicht unter `accounts`).
properties:
value:
type: array
description: Token-Konten für die aktuelle Seite.
items:
$ref: '#/components/schemas/TokenAccountByOwnerV2Entry'
paginationKey:
type: string
description: >-
Paginierungscursor für die nächste Seite. Nur null, wenn keine
Token-Konten zurückgegeben werden (Ende der Paginierung). Beachten
Sie, dass weniger Konten als das Limit zurückgegeben werden können,
dies weist jedoch nicht auf das Ende der Paginierung hin.
example: 8WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
nullable: true
TokenAccountsByOwnerV2Page:
type: object
description: >-
Paginierte Token-Konten, wenn `withContext` wahr ist. Enthält `accounts`
und `paginationKey` unter `result.value` zusammen mit `result.context`.
properties:
accounts:
type: array
description: Token-Konten für die aktuelle Seite.
items:
$ref: '#/components/schemas/TokenAccountByOwnerV2Entry'
paginationKey:
type: string
description: >-
Paginierungscursor für die nächste Seite. Nur null, wenn keine
Token-Konten zurückgegeben werden (Ende der Paginierung). Beachten
Sie, dass weniger Konten als das Limit zurückgegeben werden können,
dies weist jedoch nicht auf das Ende der Paginierung hin.
example: 8WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
nullable: true
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: Bezeichner, der mit der Anfrage übereinstimmt.
example: '1'
TokenAccountByOwnerV2Entry:
type: object
properties:
pubkey:
type: string
description: Konto-Pubkey als base-58 codierter String.
example: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
type: object
description: Details des Token-Kontos.
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-Statusdaten, die dem Konto zugeordnet sind.
properties:
program:
type: string
description: Programmname.
example: spl-token
parsed:
type: object
description: Bereinigte 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: Details der Token-Menge.
properties:
amount:
type: string
description: Rohsaldo ohne Dezimalstellen.
example: '420000000000000'
decimals:
type: integer
description: Anzahl der Dezimalstellen.
example: 6
uiAmount:
type: number
description: Guthaben in benutzerfreundlichem Format.
example: 420000000
uiAmountString:
type: string
description: Guthaben als String.
example: '420000000'
space:
type: integer
description: Für das Konto zugewiesener Speicherplatz.
example: 165
executable:
type: boolean
description: Gibt an, ob das Konto ein Programm enthält.
example: false
rentEpoch:
type: integer
description: Epoche, an der das Konto das nächste Mal Miete schuldet.
example: 18446744073709552000
space:
type: integer
description: Datenmenge des Kontos.
example: 165
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.
````