Die Wallet-API befindet sich in der Betaversion. Endpunkte und Antwortformate können sich ändern.
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-URLhttps://api.helius.xyz und geben Beträge in benutzerfreundlichen Einheiten zurück (keine Lamport-Umrechnung erforderlich).
Warum Helius für Wallet-Daten?
Ein REST-Aufruf
Strukturierte Salden, Verlauf und Übertragungen ohne Zusammenfügen roher
RPC-Antworten.
USD-Preise integriert
Token-Salden beinhalten USD-Werte und Portfolio-Gesamtsummen, bezogen von DAS.
Identitätsauflösung
32.500+ gekennzeichnete Konten und Programme sowie 21,5 Mio.+ kategorische Tags für
Börsen, Protokolle und Institutionen.
Benutzerfreundliche Ausgabe
Klare, dezimalangepasste Daten anstelle roher Lamports und Anweisungen.
Wichtige Endpunkte
Wallet-Identität
Identifizieren Sie bekannte Wallets nach Adresse oder SNS/ANS-Domain — Börsen, Protokolle,
Institutionen.
Wallet-Salden
Alle Token- und NFT-Salden mit USD-Werten, Logos und Metadaten.
Historischer Saldo
Ein Token- oder SOL-Saldo zu einem früheren Timestamp, Datum oder Slot.
Wallet-Verlauf
Vollständiger Transaktionsverlauf mit Saldoänderungen für jede Transaktion.
Token-Übertragungen
Alle eingehenden und ausgehenden Übertragungen mit Absender-/Empfängerinformationen.
Finanzierungsquelle
Die ursprüngliche Finanzierungsquelle einer Wallet, verfolgt bis zur ersten eingehenden SOL.
Welchen Endpunkt sollte ich verwenden?
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 erhaltenPOST /v1/wallet/batch-identity— Batch-Identitätsabfrage (bis zu 100 Adressen und/oder Domains)GET /v1/wallet/{wallet}/balances— Alle Token- und NFT-Salden erhaltenGET /v1/wallet/{wallet}/balance-at— Einen Token- oder SOL-Saldo zu einem früheren Timestamp, Datum oder Slot erhaltenGET /v1/wallet/{wallet}/history— Transaktionsverlauf mit Saldoänderungen erhaltenGET /v1/wallet/{wallet}/transfers— Alle Token-Übertragungsaktivitäten erhaltenGET /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:- Abfrageparameter
- Header
Plananforderungen
Die Endpunkte für Identität und Finanzierungsquelle erfordern einen kostenpflichtigen Plan. Im kostenlosen Plan geben Anfragen zu diesen Endpunkten403 Forbidden zurück. Jeder andere Endpunkt ist in allen Plänen offen, einschließlich des kostenlosen Plans.
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.
Beträge und Einheiten
Die Wallet-API ist eine hochrangige Abstraktion über rohe Solana-Daten. Alleamount 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
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
1
Holen Sie sich Ihren API-Schlüssel
Registrieren Sie sich unter dashboard.helius.dev, um Ihren API-Schlüssel zu erhalten.
2
Wählen Sie Ihren Endpunkt
Verwenden Sie die obige Tabelle, um den zu Ihrem Anwendungsfall passenden Endpunkt auszuwählen.
3
Stellen Sie Ihre erste Anfrage
Beginnen Sie mit einer einfachen Saldoabfrage:
4
Verarbeiten Sie die Antwort
Parsen Sie die JSON-Antwort und zeigen Sie die Daten in Ihrer Anwendung an.
Nächste Schritte
Daten abrufen
Entdecken Sie alle Möglichkeiten, Solana-Daten auf Helius abzufragen.
API-Referenz
Anforderungs- und Antwortschemas für alle Wallet-API-Endpunkte.
Support kontaktieren
Holen Sie sich Hilfe über Discord, Chat oder E-Mail.