Zum Hauptinhalt springen
Die Wallet API befindet sich in der Beta-Phase. Endpoints und response-Formate können sich ändern.

​
Was ist die Wallet API?

Die Wallet API bietet REST-endpoints auf hoher Abstraktionsebene, mit denen du vollständige Daten zu Solana-Wallets abfragen kannst – Guthaben, Transaktionsverlauf, Token-Übertragungen, Identitätsauflösung, historische Guthaben und Finanzierungsquellen. Statt mehrere RPC-Aufrufe durchzuführen und Blockchain-Rohdaten zu parsen, erhältst du mit einem einzigen request strukturierte, menschenlesbare Informationen einschließlich USD-Preisen. Sie wurde für Wallets, Portfolio-Tracker, Explorer, Zahlungsabwickler, Steuer-Tools sowie Compliance- und AML-Systeme entwickelt. Alle endpoints verwenden die Basis-URL https://api.helius.xyz und geben Beträge in menschenlesbaren Einheiten zurück. Eine Umrechnung von Lamports ist nicht erforderlich.

​
Warum Helius für Wallet-Daten?

One REST call

Strukturierte Guthaben, Verläufe und Übertragungen, ohne rohe RPC-responses zusammenführen zu müssen.

USD pricing built in

Token-Guthaben enthalten USD-Werte und Portfoliowerte aus DAS.

Identity resolution

Mehr als 32.500 gekennzeichnete Konten und Programme sowie über 21,5 Millionen Kategorietags für Börsen, Protokolle und Institutionen.

Human-readable output

Klare, an Dezimalstellen angepasste Daten statt roher Lamports und Anweisungen.

​
Wichtige endpoints

Wallet Identity

Identifiziere bekannte Wallets anhand ihrer Adresse oder SNS-/ANS-Domain – Börsen, Protokolle und Institutionen.

Wallet Balances

Alle Token- und NFT-Guthaben mit USD-Werten, Logos und Metadaten.

Historical Balance

Das Guthaben eines Tokens oder SOL zu einem früheren Zeitstempel, Datum mit Uhrzeit oder slot.

Wallet History

Vollständiger Transaktionsverlauf mit Guthabenänderungen für jede Transaktion.

Token Transfers

Alle ein- und ausgehenden Übertragungen mit Informationen zu Absender und Empfänger.

Funding Source

Die ursprüngliche Finanzierungsquelle einer Wallet, zurückverfolgt bis zum ersten SOL-Eingang.

​
Welchen endpoint sollte ich verwenden?

Kurzreferenz der zugrunde liegenden Routen (Basis-URL https://api.helius.xyz):
  • GET /v1/wallet/{wallet}/identity — Wallet-Identität anhand einer Adresse oder SNS-/ANS-Domain abrufen
  • POST /v1/wallet/batch-identity — Identitäten gesammelt abfragen (bis zu 100 Adressen und/oder Domains)
  • GET /v1/wallet/{wallet}/balances — alle Token- und NFT-Guthaben abrufen
  • GET /v1/wallet/{wallet}/balance-at — Guthaben eines Tokens oder SOL zu einem früheren Zeitstempel, Datum mit Uhrzeit oder slot abrufen
  • GET /v1/wallet/{wallet}/history — Transaktionsverlauf mit Guthabenänderungen abrufen
  • GET /v1/wallet/{wallet}/transfers — sämtliche Token-Übertragungen abrufen
  • GET /v1/wallet/{wallet}/funded-by — ursprüngliche Finanzierungsquelle ermitteln

​
Authentifizierung

Alle requests an die Wallet API benötigen einen API key. Du kannst ihn als Abfrageparameter oder als Header übergeben:

​
Tarifanforderungen

Die endpoints für Identität und Finanzierungsquelle erfordern einen kostenpflichtigen Tarif. Im kostenlosen Tarif geben requests an diese endpoints 403 Forbidden zurück. Alle anderen endpoints sind in sämtlichen Tarifen verfügbar, einschließlich des kostenlosen Tarifs. Jeder kostenpflichtige Tarif schaltet die geschützten endpoints frei – Developer, Business und alle höheren Tarife wie Enterprise. Um Abfragen für Identitäten und Finanzierungsquellen zu aktivieren, führe im Dashboard ein Tarif-Upgrade durch.

​
Beträge und Einheiten

Die Wallet API abstrahiert rohe Solana-Daten auf hoher Ebene. Alle amount-Felder in responses sind menschenlesbar und bereits durch decimals des Tokens geteilt. Du kannst sie daher ohne Umrechnung direkt anzeigen. Rohe Solana-RPC-Aufrufe geben Werte in Lamports zurück, der kleinsten Einheit (10⁻⁹ SOL). Die Wallet API tut das nicht. "amount": 1.5 bedeutet 1,5 SOL, nicht 1,5 Lamports. Wenn du exakte Berechnungen benötigst, stellen einige endpoints zusätzlich amountRaw bereit: denselben Wert als rohe Ganzzahl, die als String serialisiert ist, um Genauigkeitsverluste bei Gleitkommazahlen zu vermeiden. Die Umrechnungsformel lautet: amount = parseInt(amountRaw) / 10**decimals Verwende amount für die Anzeige. Verwende amountRaw, wenn du Werte an On-Chain-Anweisungen oder andere Systeme übergibst, die exakte Ganzzahlarithmetik erfordern.

​
Erste Schritte

1

Get your API key

Registriere dich auf dashboard.helius.dev, um deinen API key zu erhalten.
2

Choose your endpoint

Wähle anhand der obigen Tabelle den endpoint aus, der zu deinem Anwendungsfall passt.
3

Make your first request

Beginne mit einer einfachen Guthabenabfrage:
4

Handle the response

Parse die JSON-response und zeige die Daten in deiner Anwendung an.

​
Nächste Schritte

Getting Data

Entdecke alle Möglichkeiten, Solana-Daten über Helius abzufragen.

API Reference

Request- und response-Schemas für alle endpoints der Wallet API.

Contact Support

Erhalte Hilfe über Discord, Chat oder E-Mail.