> ## 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.
# Abrufen von Wallet-Salden
> Abrufen von Token-Salden und SOL-Beständen für eine Solana-Wallet-Adresse.
Jede Anfrage kostet **100 Credits**.
## Anforderungsparameter
Solana-Wallet-Adresse (base58 kodiert)
Seitennummer für die Paginierung (1-indiziert)
Maximale Anzahl von Token pro Seite
Token mit Nullsaldo einbeziehen
Native SOL in den Ergebnissen einbeziehen
NFTs in den Ergebnissen einbeziehen (max. 100, nur erste Seite)
## OpenAPI
````yaml de/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/balances
openapi: 3.0.3
info:
title: Wallet-API
description: >-
Eine leistungsstarke REST-API zum Abfragen von Solana-Wallet-Daten
einschließlich Salden, Transaktionshistorie, Überweisungen und
Identitätsinformationen.
## Authentifizierung
Alle Anfragen erfordern einen API-Schlüssel, der entweder als:
- Query-Parameter: `?api-key=YOUR_API_KEY`
- Header: `X-Api-Key: YOUR_API_KEY`
übergeben wird.
version: 1.0.0
contact:
name: API-Unterstützung
url: https://helius.dev
servers:
- url: https://api.helius.xyz
description: Produktionsserver
security:
- ApiKeyQuery: []
- ApiKeyHeader: []
tags:
- name: Identität
description: Wallet-Identitäten und bekannte Adressen nachschlagen
- name: Salden
description: Token- und NFT-Salden abfragen
- name: Historie
description: Transaktionsverlauf und Saldenänderungen
- name: Überweisungen
description: Token-Übertragungsaktivität
- name: Finanzierung
description: Informationen zur Wallet-Finanzierung
paths:
/v1/wallet/{wallet}/balances:
get:
tags:
- Salden
summary: Wallet-Salden abrufen
description: >
Token- und NFT-Salden für eine Wallet abrufen. **Die Paginierung erfolgt
manuell** - die API gibt bis zu 100 Tokens pro Anfrage zurück.
Ergebnisse sind nach USD-Wert in absteigender Reihenfolge sortiert.
Tokens mit Preisdaten erscheinen zuerst, gefolgt von Tokens ohne Preise.
**Paginierung:** Verwenden Sie den `page`-Parameter, um weitere Seiten
abzurufen. Die Antwort enthält `pagination.hasMore`,
um anzuzeigen, ob weitere Ergebnisse verfügbar sind. Jede Anfrage stellt
einen einzigen API-Aufruf dar und kostet 100 Credits.
operationId: getWalletBalances
parameters:
- $ref: '#/components/parameters/WalletAddress'
- name: page
in: query
description: Seitennummer für die Paginierung (1-indexiert)
schema:
type: integer
minimum: 1
default: 1
example: 1
- name: limit
in: query
description: Maximale Anzahl von Tokens pro Seite
schema:
type: integer
minimum: 1
maximum: 100
default: 100
example: 100
- name: showZeroBalance
in: query
description: Tokens mit Nullsaldo einbeziehen
schema:
type: boolean
default: false
- name: showNative
in: query
description: Native SOL in Ergebnisse einbeziehen
schema:
type: boolean
default: true
- name: showNfts
in: query
description: NFTs in Ergebnisse einbeziehen (maximal 100, nur erste Seite)
schema:
type: boolean
default: false
responses:
'200':
description: Wallet-Salden erfolgreich abgerufen
content:
application/json:
schema:
$ref: '#/components/schemas/BalancesResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
parameters:
WalletAddress:
name: wallet
in: path
required: true
description: Solana-Wallet-Adresse (base58-kodiert)
schema:
type: string
pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
example: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
schemas:
BalancesResponse:
type: object
properties:
balances:
type: array
items:
$ref: '#/components/schemas/TokenBalance'
description: >
Array von Token-Salden für die aktuelle Seite, einschließlich native
SOL.
Wenn showNative=true, erscheint SOL als erstes Element mit der
Mint-Adresse So11111111111111111111111111111111111111112.
Andere Tokens sind nach USD-Wert (absteigend) sortiert.
nfts:
type: array
items:
$ref: '#/components/schemas/Nft'
description: >-
Array von NFT-Beständen (nur enthalten, wenn showNfts=true, max.
100, nur erste Seite)
totalUsdValue:
type: number
description: >-
Gesamter USD-Wert der Salden auf dieser Seite (nicht der gesamte
Portfoliowert)
example: 217.98
pagination:
type: object
description: >-
Paginierungsmetadaten. Benutzer müssen manuell zusätzliche Seiten
mit dem Seitenparameter anfordern.
properties:
page:
type: integer
description: Aktuelle Seitennummer
example: 1
limit:
type: integer
description: Anzahl der Elemente pro Seite
example: 100
hasMore:
type: boolean
description: >-
Wahr, wenn weitere Ergebnisse verfügbar sind. Erhöhen Sie den
Seitenparameter, um die nächste Seite abzurufen.
example: true
required:
- page
- limit
- hasMore
required:
- balances
- totalUsdValue
- pagination
TokenBalance:
type: object
properties:
mint:
type: string
description: Token-Mint-Adresse
example: So11111111111111111111111111111111111111112
symbol:
type: string
nullable: true
description: Token-Symbol
example: SOL
name:
type: string
nullable: true
description: Token-Name
example: Solana
balance:
type: number
description: Token-Saldo (angepasst an Dezimalstellen)
example: 1.5
decimals:
type: integer
description: Anzahl der Dezimalstellen
example: 9
pricePerToken:
type: number
nullable: true
description: Preis pro Token in USD
example: 145.32
usdValue:
type: number
nullable: true
description: Gesamter USD-Wert der Bestände
example: 217.98
logoUri:
type: string
nullable: true
description: URL zum Token-Logo-Bild
example: https://example.com/sol-logo.png
tokenProgram:
type: string
enum:
- spl-token
- token-2022
description: >-
Token-Programmtyp (spl-token für Legacy, token-2022 für neuen
Standard)
example: spl-token
required:
- mint
- balance
- decimals
- tokenProgram
Nft:
type: object
properties:
mint:
type: string
description: NFT-Mint-Adresse
example: 7Xq8wXyXVqfBPPqVJjPDwG9zN5wCVxBYZ6z7vPYBzr6F
name:
type: string
nullable: true
description: NFT-Name
example: Degen Ape
imageUri:
type: string
nullable: true
description: NFT-Bild-URI
example: https://example.com/nft.png
collectionName:
type: string
nullable: true
description: Sammlungsname
example: Degen Ape Academy
collectionAddress:
type: string
nullable: true
description: Sammlungsadresse
example: DegN1dXmU2uYa4n7U9qTh7YNYpK4u8L9qXx7XqYqJfGH
compressed:
type: boolean
description: Ob dies ein komprimiertes NFT ist
example: false
required:
- mint
- compressed
Error:
type: object
properties:
error:
type: string
description: Fehlermeldung
example: Invalid wallet address
code:
type: integer
description: HTTP-Statuscode
example: 400
details:
type: string
description: Zusätzliche Fehlerdetails
example: '''invalid-address'' is not a valid Solana address'
required:
- error
- code
responses:
BadRequest:
description: Ungültige Anforderungsparameter
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Invalid wallet address
code: 400
details: '''invalid-address'' is not a valid Solana address'
Unauthorized:
description: Fehlender oder ungültiger API-Schlüssel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: API key required. Pass via ?api-key=xxx or X-Api-Key header
code: 401
RateLimited:
description: Ratenlimit überschritten.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: RATE_LIMIT_EXCEEDED
code: 429
details: Too many requests. Retry after 2 seconds.
InternalError:
description: Vorübergehender Serverfehler. Wiederholbar mit exponentiellem Backoff.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: INTERNAL_ERROR
code: 500
details: An unexpected error occurred. Please retry.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: API-Schlüssel als Query-Parameter übergeben
ApiKeyHeader:
type: apiKey
in: header
name: X-Api-Key
description: API-Schlüssel im Anforderungsheader übergeben
````