Die Wallet-API befindet sich in der Beta-Phase. Endpunkte und Antwortformate können sich ändern.
Übersicht
Der Wallet-Guthaben-Endpunkt ruft alle Token- und NFT-Bestände für ein Solana-Wallet ab — SOL, SPL-Token, Token-2022 und NFTs — mit USD-Preisen, Logos und Metadaten. Die Ergebnisse sind nach USD-Wert in absteigender Reihenfolge sortiert: Token mit Preisdaten erscheinen zuerst, gefolgt von Token ohne Preise. Der Endpunkt gibt bis zu 100 Token pro Anfrage zurück, daher ist die Paginierung manuell. Verwenden Sie denpage-Parameter, um zusätzliche Seiten abzurufen, und lesen Sie pagination.hasMore, um zu wissen, wann weitere Ergebnisse verfügbar sind. Jede Anfrage ist ein einzelner API-Aufruf und kostet 100 Credits.
USD-Preise stammen von DAS und werden stündlich aktualisiert, wobei die Top 10.000 Token nach Marktkapitalisierung abgedeckt werden.
pricePerToken und usdValue sind null für nicht unterstützte Token. Preise sind Schätzungen, keine Echtzeit-Marktraten.Wann man dies verwendet
Verwenden Sie die Wallet-Guthaben-API, wenn Sie:- Portfolio-Bestände anzeigen: zeigen Sie Benutzern ihre vollständigen Token- und NFT-Bestände.
- USD-Werte berechnen: erhalten Sie Portfolio-Bewertungen mit stündlich aktualisierten Preisen.
- Wallet-UIs erstellen: Wallet-Dashboards und Asset-Listen erstellen.
- Token-Bestände verfolgen: spezifische Token-Guthaben über Wallets hinweg überwachen.
- Portfolio-Analysen: Analyse der Verteilung und Konzentration von Beständen.
- Steuerberichte: Erzeugen von Bestandsaufnahmen für Steuerzwecke.
Schnellstart
Basisabfrage des Guthabens
Holen Sie sich alle Token-Guthaben für ein Wallet mit USD-Werten:- JavaScript
- Python
- cURL
NFTs in Ergebnisse einschließen
Holen Sie sich sowohl Token als auch NFTs in einer einzigen Anfrage mitshowNfts=true:
- JavaScript
- Python
Ergebnisse filtern
Verwenden Sie Abfrageparameter, um die Rückgabe einzugrenzen:Abfrageparameter
Antwortformat
Feldhinweise
balance: menschlich lesbarer Betrag, bereits für Dezimalstellen angepasst —1.5bedeutet 1.5 SOL und1000.5bedeutet 1000.5 USDC. Keine Lamport-Umrechnung erforderlich. Dieser Endpunkt zeigt kein rohesamountRaw-Feld an; wenn Sie den genauen ganzzahligen Wert benötigen, leiten Sie ihn ab alsMath.round(balance * 10 ** decimals).decimals: nur zur Referenz bereitgestellt.pricePerToken/usdValue:nullfür Token ohne DAS-Preisdaten (siehe die Preisnotiz oben).totalUsdValue: Gesamter USD-Wert nur für die aktuelle Antwortseite. Für den Wert des gesamten Portfolios paginieren Sie durch alle Seiten und summieren Sie dasusdValuejedes Guthabens.tokenProgram: welcher Token-Standard von jedem Token verwendet wird —spl-token(Legacy SPL Token) odertoken-2022(Token Extensions). Beide sind vollständig unterstützt.
Anwendungsfälle
Eine Portfolio-Dashboard erstellen
Benutzerbestände mit USD-Werten anzeigen:Token-Konzentration berechnen
Portfolio-Diversifikation analysieren:Gesamtes Guthaben eines bestimmten Tokens verfolgen
Verfolgen Sie ein bestimmtes Token in mehreren Wallets:Bestände für die Steuerberichterstattung exportieren
Eine Bestandsaufnahme erzeugen:Paginierung
Für Wallets mit mehr als 100 Token blättern Sie mit dempage-Parameter und pagination.hasMore durch die Ergebnisse:
Best Practices
- Null-Balances für eine sauberere Benutzeroberfläche filtern. Verwenden Sie
showZeroBalance=false, um Token auszublenden, die das Wallet nicht mehr hält. - NFTs nur bei Bedarf einbeziehen. NFTs sind standardmäßig für die Leistung ausgeschlossen; setzen Sie
showNfts=truenur, wenn sie angezeigt werden sollen. - Fehlende Preisdaten handhaben. Überprüfen Sie immer, ob
pricePerTokenundusdValuenullsind, bevor Sie sie anzeigen. Diese sind stündliche Schätzungen von DAS, keine Echtzeit-Marktraten. - Antworten zwischenspeichern. Kontodaten können für einige Sekunden zwischengespeichert werden, um API-Aufrufe zu reduzieren.
- Große Wallets paginieren. Einige Wallets halten Tausende von Tokens; implementieren Sie die Paginierung, um sie effizient zu handhaben.
Häufige Fehler
Nächste Schritte
Historisches Guthaben
Erhalten Sie ein Token- oder SOL-Guthaben zu einem vergangenen Zeitstempel, Datum/Uhrzeit oder Slot.
Wallet-API-Übersicht
Alle Wallet-API-Endpunkte und gemeinsam genutzte Konventionen.
API-Referenz
Anforderungs- und Antwortschemata für Wallet-Guthaben.