> ## 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.

# Wallet-API-Übersicht (Beta)

> Abfragen von Solana-Wallet-Daten mit der Wallet-API. Erhalten Sie Salden, Transaktionsverlauf, Überweisungen, Identitätsinformationen und Finanzierungsquellen in einer einzigen Anfrage.

<Note>
  Die Wallet-API befindet sich in der Betaversion. Endpunkte und Antwortformate können sich ändern.
</Note>

## Was ist die Wallet-API?

Die Wallet-API bietet hochrangige REST-Endpunkte für die Abfrage vollständiger Solana-Wallet-Daten – Salden, Transaktionsverlauf, Token-Übertragungen, Identitätsauflösung, historische Salden und Finanzierungsquellen. Anstatt mehrere RPC-Aufrufe zu machen und rohe Blockchain-Daten zu analysieren, erhalten Sie strukturierte, benutzerfreundliche Informationen mit USD-Preisen in einer einzigen Anfrage.

Sie ist konzipiert für Wallets, Portfolio-Tracker, Explorer, Zahlungsabwickler, Steuer-Tools und Compliance- sowie AML-Systeme. Alle Endpunkte teilen sich die Basis-URL `https://api.helius.xyz` und geben Beträge in benutzerfreundlichen Einheiten zurück (keine Lamport-Umrechnung erforderlich).

## Warum Helius für Wallet-Daten?

<CardGroup cols={2}>
  <Card title="Ein REST-Aufruf" icon="bolt">
    Strukturierte Salden, Verlauf und Übertragungen ohne Zusammenfügen roher
    RPC-Antworten.
  </Card>

  <Card title="USD-Preise integriert" icon="dollar-sign">
    Token-Salden beinhalten USD-Werte und Portfolio-Gesamtsummen, bezogen von DAS.
  </Card>

  <Card title="Identitätsauflösung" icon="address-card">
    32.500+ gekennzeichnete Konten und Programme sowie 21,5 Mio.+ kategorische Tags für
    Börsen, Protokolle und Institutionen.
  </Card>

  <Card title="Benutzerfreundliche Ausgabe" icon="book-open">
    Klare, dezimalangepasste Daten anstelle roher Lamports und Anweisungen.
  </Card>
</CardGroup>

## Wichtige Endpunkte

<CardGroup cols={2}>
  <Card title="Wallet-Identität" icon="address-card" href="/docs/de/wallet-api/identity">
    Identifizieren Sie bekannte Wallets nach Adresse oder SNS/ANS-Domain — Börsen, Protokolle,
    Institutionen.
  </Card>

  <Card title="Wallet-Salden" icon="scale-balanced" href="/docs/de/wallet-api/balances">
    Alle Token- und NFT-Salden mit USD-Werten, Logos und Metadaten.
  </Card>

  <Card title="Historischer Saldo" icon="clock" href="/docs/de/wallet-api/balance-at">
    Ein Token- oder SOL-Saldo zu einem früheren Timestamp, Datum oder Slot.
  </Card>

  <Card title="Wallet-Verlauf" icon="clock-rotate-left" href="/docs/de/wallet-api/history">
    Vollständiger Transaktionsverlauf mit Saldoänderungen für jede Transaktion.
  </Card>

  <Card title="Token-Übertragungen" icon="arrow-right-arrow-left" href="/docs/de/wallet-api/transfers">
    Alle eingehenden und ausgehenden Übertragungen mit Absender-/Empfängerinformationen.
  </Card>

  <Card title="Finanzierungsquelle" icon="money-bill-transfer" href="/docs/de/wallet-api/funded-by">
    Die ursprüngliche Finanzierungsquelle einer Wallet, verfolgt bis zur ersten eingehenden SOL.
  </Card>
</CardGroup>

## Welchen Endpunkt sollte ich verwenden?

| Sie benötigen                                 | Verwenden Sie dies                              | Gibt zurück                                               |
| --------------------------------------------- | ----------------------------------------------- | --------------------------------------------------------- |
| Wer eine Wallet ist (Börse, Protokoll, Label) | [Identität](/docs/de/wallet-api/identity)            | Name, Kategorie und Tags für bekannte Adressen            |
| Das aktuelle Portfolio einer Wallet           | [Salden](/docs/de/wallet-api/balances)               | Alle Tokens und NFTs mit USD-Werten                       |
| Ein Saldo zu einem früheren Zeitpunkt         | [Historischer Saldo](/docs/de/wallet-api/balance-at) | Ein Token- oder SOL-Saldo zu einem Timestamp/Datum/Slot   |
| Vollständige Transaktionsaktivität            | [Verlauf](/docs/de/wallet-api/history)               | Analysierte Transaktionen mit Transaktionssaldoänderungen |
| Nur gesendete/empfangene Übertragungen        | [Übertragungen](/docs/de/wallet-api/transfers)       | Übertragungsansicht mit Gegenpartei und Richtung          |
| Woher die Mittel einer Wallet stammen         | [Finanzierungsquelle](/docs/de/wallet-api/funded-by) | Erste eingehende SOL-Übertragung und ihr Absender         |

Kurze Übersicht der zugrunde liegenden Routen (Basis-URL `https://api.helius.xyz`):

* `GET /v1/wallet/{wallet}/identity` — Wallet-Identität nach Adresse oder SNS/ANS-Domain erhalten
* `POST /v1/wallet/batch-identity` — Batch-Identitätsabfrage (bis zu 100 Adressen und/oder Domains)
* `GET /v1/wallet/{wallet}/balances` — Alle Token- und NFT-Salden erhalten
* `GET /v1/wallet/{wallet}/balance-at` — Einen Token- oder SOL-Saldo zu einem früheren Timestamp, Datum oder Slot erhalten
* `GET /v1/wallet/{wallet}/history` — Transaktionsverlauf mit Saldoänderungen erhalten
* `GET /v1/wallet/{wallet}/transfers` — Alle Token-Übertragungsaktivitäten erhalten
* `GET /v1/wallet/{wallet}/funded-by` — Die ursprüngliche Finanzierungsquelle finden

## Authentifizierung

Alle Wallet-API-Anfragen erfordern einen API-Schlüssel. Sie können ihn als Abfrageparameter oder als Header übergeben:

<Tabs>
  <Tab title="Abfrageparameter">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"
    ```
  </Tab>

  <Tab title="Header">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances" \
      -H "X-Api-Key: YOUR_API_KEY"
    ```
  </Tab>
</Tabs>

## Plananforderungen

Die Endpunkte für Identität und Finanzierungsquelle erfordern einen kostenpflichtigen Plan. Im kostenlosen Plan geben Anfragen zu diesen Endpunkten `403 Forbidden` zurück. Jeder andere Endpunkt ist in allen Plänen offen, einschließlich des kostenlosen Plans.

| Endpunkt                             | Kostenloser Plan                   |
| ------------------------------------ | ---------------------------------- |
| `GET /v1/wallet/{wallet}/identity`   | `403` — nur kostenpflichtige Pläne |
| `POST /v1/wallet/batch-identity`     | `403` — nur kostenpflichtige Pläne |
| `GET /v1/wallet/{wallet}/funded-by`  | `403` — nur kostenpflichtige Pläne |
| `GET /v1/wallet/{wallet}/balances`   | Verfügbar                          |
| `GET /v1/wallet/{wallet}/balance-at` | Verfügbar                          |
| `GET /v1/wallet/{wallet}/history`    | Verfügbar                          |
| `GET /v1/wallet/{wallet}/transfers`  | Verfügbar                          |

Jede kostenpflichtige Stufe schaltet die gesperrten Endpunkte frei — Entwickler-, Geschäfts- und alle höheren Stufen (wie Enterprise). Um Identitäts- und Finanzierungsquellenabfragen zu aktivieren, [aktualisieren Sie Ihren Plan im Dashboard](https://dashboard.helius.dev).

## Beträge und Einheiten

Die Wallet-API ist eine hochrangige Abstraktion über rohe Solana-Daten. Alle `amount` Felder in den Antworten sind **benutzerfreundlich** — bereits durch den Token's `decimals` geteilt — sodass Sie sie direkt ohne Umrechnung anzeigen können. Rohe Solana-RPC-Aufrufe geben Werte in Lamports zurück (die kleinste Einheit, 10⁻⁹ SOL); dies tut die Wallet-API nicht. `"amount": 1.5` bedeutet 1,5 SOL, nicht 1,5 Lamports.

Wo genaue Arithmetik erforderlich ist, stellen einige Endpunkte auch `amountRaw` bereit: denselben Wert als roher Ganzzahl-String, um Verluste bei Gleitkommapräzision zu vermeiden. Die Umrechnungsformel lautet:

`amount = parseInt(amountRaw) / 10**decimals`

| Endpunkt                       | Benutzerfreundlicher `amount`         | Roher `amountRaw` String |
| ------------------------------ | ------------------------------------- | ------------------------ |
| **Salden**                     | `balance` Feld                        | Nicht verfügbar          |
| **Saldo-zu**                   | `balance` Feld (dezimaler **String**) | `balanceRaw` Feld        |
| **Finanziert-von**             | `amount` Feld                         | `amountRaw` Feld         |
| **Übertragungen**              | `amount` Feld                         | `amountRaw` Feld         |
| **Verlauf** (`balanceChanges`) | `amount` Feld                         | Nicht verfügbar          |

Verwenden Sie `amount` zur Anzeige. Verwenden Sie `amountRaw`, wenn Sie Werte an On-Chain-Anweisungen oder andere Systeme übergeben, die exakte Ganzzahl-Arithmetik erfordern.

## Erste Schritte

<Steps>
  <Step title="Holen Sie sich Ihren API-Schlüssel">
    Registrieren Sie sich unter [dashboard.helius.dev](https://dashboard.helius.dev), um Ihren API-Schlüssel zu erhalten.
  </Step>

  <Step title="Wählen Sie Ihren Endpunkt">
    Verwenden Sie die obige Tabelle, um den zu Ihrem Anwendungsfall passenden Endpunkt auszuwählen.
  </Step>

  <Step title="Stellen Sie Ihre erste Anfrage">
    Beginnen Sie mit einer einfachen Saldoabfrage:

    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
    ```
  </Step>

  <Step title="Verarbeiten Sie die Antwort">
    Parsen Sie die JSON-Antwort und zeigen Sie die Daten in Ihrer Anwendung an.
  </Step>
</Steps>

## Nächste Schritte

<CardGroup cols={3}>
  <Card title="Daten abrufen" icon="database" href="/docs/de/getting-data">
    Entdecken Sie alle Möglichkeiten, Solana-Daten auf Helius abzufragen.
  </Card>

  <Card title="API-Referenz" icon="code" href="/docs/de/api-reference/wallet-api">
    Anforderungs- und Antwortschemas für alle Wallet-API-Endpunkte.
  </Card>

  <Card title="Support kontaktieren" icon="headset" href="/docs/de/support/contact-support">
    Holen Sie sich Hilfe über Discord, Chat oder E-Mail.
  </Card>
</CardGroup>