> ## 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.
# Erhalte historischen Token-Saldo
> Erhalte den Saldo einer Wallet für ein spezifisches Token oder native SOL zu einem vergangenen Zeitpunkt, Datum oder Slot.
Jede Anfrage kostet **100 Credits**.
## Anfrageparameter
Solana Wallet-Adresse (base58 codiert)
Token Mint-Adresse. Für native SOL, benutze `So11111111111111111111111111111111111111111`.
Unix-Zeitstempel in **Sekunden**. Gibt den Saldo zu diesem Zeitpunkt zurück. Gib genau eines der `time`, `datetime` oder `slot` an.
Datums- und Zeitstring. Akzeptierte Formate: `2025-01-10` (UTC Mitternacht), `2025-01-10 19:20:00`,
`2025-01-10T19:20:00` (Sekunden optional) oder mit einer expliziten Zeitzone
(`2025-01-10T19:20:00Z`, `...+02:00`). **Wird als UTC interpretiert, sofern keine explizite
Zeitzone angegeben ist.** Gib genau eines der `time`, `datetime` oder `slot` an.
Slot-Nummer. Gibt den Saldo zu diesem Slot zurück. Genau und deterministisch. Gib genau eines der `time`, `datetime` oder `slot` an.
## OpenAPI
````yaml de/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/balance-at
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}/balance-at:
get:
tags:
- Salden
summary: Historischen Saldo abrufen
description: >
Abrufen des Wallet-Saldos eines bestimmten Tokens (oder native SOL) zu
einem Punkt in der Vergangenheit, angegeben als Unix-Zeitstempel,
Datetime-String oder Slotnummer.
Der Saldo wird aus der letzten Transaktion der Wallet mit dem Token
**bei oder
vor** dem angeforderten Zeitpunkt gelesen — ihrem
Nach-Transaktionssaldo, der per Definition
bis zur nächsten Transaktion der Wallet gehalten wurde. Dies ist ein
genauer Wert, keine Schätzung.
**Genau einer** von `time`, `datetime` oder `slot` muss angegeben
werden. `datetime`-Werte
ohne explizite Zeitzone werden als **UTC** interpretiert. Für genaue,
deterministische Ergebnisse
verwenden Sie `slot` — Blockzeiten, die von Validatoren berichtet
werden, können um einige Sekunden abweichen.
Für native SOL verwenden Sie den Pseudo-Mint
`So11111111111111111111111111111111111111111` als `mint`.
Eine Wallet ohne übereinstimmende Aktivität bei oder vor dem
angeforderten Punkt ist **kein** Fehler —
der Endpunkt gibt `200` mit `balance: "0"` und `asOf: null` zurück.
`balance` und `balanceRaw` werden als **Strings** zurückgegeben, um
Präzisionsverluste bei großen Werten zu vermeiden.
operationId: getWalletBalanceAt
parameters:
- $ref: '#/components/parameters/WalletAddress'
- name: mint
in: query
required: true
description: >-
Token-Mint-Adresse. Für native SOL verwenden Sie
`So11111111111111111111111111111111111111111`.
schema:
type: string
default: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
- name: time
in: query
description: >-
Unix-Zeitstempel in **Sekunden**. Gibt den Saldo zu diesem Zeitpunkt
zurück. Geben Sie genau einen von `time`, `datetime` oder `slot` an.
schema:
type: integer
default: 1750000000
minimum: 0
example: 1736536800
- name: datetime
in: query
description: >
Datetime-String. Akzeptierte Formate: `2025-01-10` (UTC
Mitternacht), `2025-01-10 19:20:00`,
`2025-01-10T19:20:00` (Sekunden optional) oder mit einer expliziten
Zeitzone
(`2025-01-10T19:20:00Z`, `...+02:00`). **Wird als UTC interpretiert,
es sei denn, es ist eine explizite
Zeitzone angegeben.** Geben Sie genau einen von `time`, `datetime`
oder `slot` an.
schema:
type: string
example: '2025-01-10 19:20:00'
- name: slot
in: query
description: >-
Slotnummer. Gibt den Saldo zu diesem Slot zurück. Genau und
deterministisch. Geben Sie genau einen von `time`, `datetime` oder
`slot` an.
schema:
type: integer
minimum: 0
example: 313000000
responses:
'200':
description: Historischer Saldo erfolgreich abgerufen
content:
application/json:
schema:
$ref: '#/components/schemas/BalanceAtResponse'
'400':
description: >-
Fehlender `mint`; ungültiger Mint; null oder mehr als einer von
`time`/`datetime`/`slot`; nicht-ganzzahliger `time`/`slot`; oder
nicht analysierbarer `datetime`
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Exactly one of time, datetime, or slot must be provided
code: 400
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Ungültige Wallet-Adresse im Pfad
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
'502':
description: >-
Upstream-RPC-Fehler oder Timeout. Wiederholbar mit exponentiellem
Backoff.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: UPSTREAM_ERROR
code: 502
details: Upstream RPC request failed. Please retry.
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:
BalanceAtResponse:
type: object
properties:
wallet:
type: string
description: Echo der abgefragten Wallet-Adresse
example: 5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9
mint:
type: string
description: Echo des abgefragten Mints (das SOL-Pseudomint, wenn nativ)
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
isNative:
type: boolean
description: Ob das Ergebnis native SOL ist
example: false
balance:
type: string
description: >-
Menschlich lesbare Menge als Dezimal-**String** (nicht als Zahl,
damit große Salden nicht an Genauigkeit verlieren). Nachkommastellen
werden getrimmt.
example: '284961463.392936'
balanceRaw:
type: string
description: Genaue Menge in der kleinsten Einheit (Lamports für SOL), als String
example: '284961463392936'
decimals:
type: integer
description: Token-Dezimalstellen (9 für SOL)
example: 6
requested:
type: object
description: >-
Echo der Abfrage. Wenn `datetime` verwendet wird, wird `time` auch
mit den aufgelösten Epoche-Sekunden gefüllt, sodass die
UTC-Interpretation sichtbar ist.
properties:
time:
type: integer
nullable: true
description: >-
Angeforderte Zeit als Epoche-Sekunden (auch gesetzt, wenn
`datetime` verwendet wurde)
example: 1736536800
slot:
type: integer
nullable: true
description: Angeforderter Slot, wenn `slot` verwendet wurde
example: null
datetime:
type: string
nullable: true
description: >-
Der ursprüngliche Datetime-String, wenn `datetime` verwendet
wurde
example: null
required:
- time
- slot
- datetime
asOf:
type: object
nullable: true
description: >-
Die Transaktion, aus der der Saldo gelesen wurde. **`null`, wenn die
Wallet keine übereinstimmende Transaktion bei oder vor dem
angeforderten Zeitpunkt hatte** — was bedeutet, dass der Saldo
wirklich `0` ist (die Wallet hat das Token bis dahin nicht
gehalten), kein Fehler.
properties:
slot:
type: integer
description: Slot der Transaktion
example: 313000000
blockTime:
type: integer
nullable: true
description: Blockzeit der Transaktion in Unix-Sekunden (kann null sein)
example: 1736536794
signature:
type: string
description: Transaktionssignatur
example: 5Cyy7Mh9nVgFq3T8wJp2sKxR4dE6bA1uZoNcLrXmYqUpon
required:
- slot
- signature
required:
- wallet
- mint
- isNative
- balance
- balanceRaw
- decimals
- requested
- asOf
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:
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
````