Skip to main content
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 den page-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:

NFTs in Ergebnisse einschließen

Holen Sie sich sowohl Token als auch NFTs in einer einzigen Anfrage mit showNfts=true:

Ergebnisse filtern

Verwenden Sie Abfrageparameter, um die Rückgabe einzugrenzen:

Abfrageparameter

Antwortformat

Feldhinweise

  • balance: menschlich lesbarer Betrag, bereits für Dezimalstellen angepasst — 1.5 bedeutet 1.5 SOL und 1000.5 bedeutet 1000.5 USDC. Keine Lamport-Umrechnung erforderlich. Dieser Endpunkt zeigt kein rohes amountRaw-Feld an; wenn Sie den genauen ganzzahligen Wert benötigen, leiten Sie ihn ab als Math.round(balance * 10 ** decimals).
  • decimals: nur zur Referenz bereitgestellt.
  • pricePerToken / usdValue: null fü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 das usdValue jedes Guthabens.
  • tokenProgram: welcher Token-Standard von jedem Token verwendet wird — spl-token (Legacy SPL Token) oder token-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 dem page-Parameter und pagination.hasMore durch die Ergebnisse:
NFTs werden nur auf der ersten Seite zurückgegeben (bis zu 100), unabhängig von der Token-Paginierung.

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=true nur, wenn sie angezeigt werden sollen.
  • Fehlende Preisdaten handhaben. Überprüfen Sie immer, ob pricePerToken und usdValue null sind, 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.