Wie überprüfe ich den Token-Guthaben anhand der Wallet-Adresse?

Direkte kettenspezifische Saldoabfragen

1. Benutzer können Token-Guthaben abrufen, indem sie eine GET-Anfrage an /balance/{chain}/{address} senden, wobei {chain} eine der sieben unterstützten Blockchains und {address} die hexadezimale Zeichenfolge des Wallets ist.

2. Der Endpunkt gibt den nativen Token-Saldo und die ERC-20/BEP-20/SPL-Token-Bestände zurück, abhängig von den kettenspezifischen Vertragsstandards und der Indexerabdeckung.

3. Zu den Antworten von Solana gehören SPL-Token-Konten, die dem Wallet zugeordnet sind, während Ethereum und Base über Multicall-Aggregation sowohl ETH- als auch Token-Guthaben zurückgeben.

4. Hedera-Abfragen geben nur natives HBAR-Guthaben zurück; HTS-Token erfordern eine separate Vertragsinteraktion, die von diesem Endpunkt nicht abgedeckt wird.

5. Bitcoin-Antworten spiegeln das UTXO-basierte BTC-Gleichgewicht ohne Unterstützung für RGB oder andere Tokenisierungsebenen wider.

Authentifizierungsanforderungen

1. Jede Guthabenanforderung muss einen X-API-Key- Header enthalten, der einen gültigen, von AgentHustle AI ausgestellten Berechtigungsnachweis enthält.

2. Schlüssel sind auf bestimmte Ketten und Berechtigungen beschränkt – der Versuch, BSC mit einem Nur-Ethereum-Schlüssel abzufragen, führt zu HTTP 403.

3. Es gelten Ratenbegrenzungen pro Schlüssel: 60 Anfragen pro Minute über alle Endpunkte hinweg, durchgesetzt auf API-Gateway-Ebene.

4. Ungültige oder abgelaufene Schlüssel lösen HTTP 401 mit einem JSON-Body aus, der „invalid_api_key“ oder „key_expired“ angibt.

5. Es sind keine Sitzungscookies oder OAuth-Flows beteiligt; Die Authentifizierung ist zustandslos und headergesteuert.

Antwortstruktur und Datenfelder

1. Erfolgreiche Antworten verwenden HTTP 200 und enthalten ein Saldofeld der obersten Ebene, das als stringisierte Ganzzahl in Basiseinheiten ausgedrückt wird (z. B. wei für ETH, Lamports für SOL).

2. Ein Token- Array listet nicht-native Assets auf, jeweils mit „contractAddress“ , „symbol“ , „decimals “ und „rawBalance“ .

3. Das Feld lastUpdated gibt den Unix-Zeitstempel in Millisekunden an, abgestimmt auf den zuletzt synchronisierten Block des zugrunde liegenden Blockchain-Indexers.

4. Bei Wallets, die über die Landeswährung hinaus keine Token enthalten, bleibt das Token- Array vorhanden, aber leer.

5. Alle numerischen Werte werden als Zeichenfolgen geliefert, um einen Verlust der Gleitkommagenauigkeit während der JSON-Serialisierung zu verhindern.

Integration der ENS-Namensauflösung

1. ENS-Namen wie vitalik.eth können direkt anstelle von Hexadezimaladressen verwendet werden, wenn der Resolver-Dienst aktiviert ist.

2. Die API führt automatisch eine umgekehrte Suche über die ENS-Registrierung des Ethereum-Mainnets durch, bevor sie die Abfrage an den kettenspezifischen Balance-Endpunkt weiterleitet.

3. Die Auflösung schlägt stillschweigend fehl, wenn der Name nicht in eine Adresse aufgelöst wird oder auf ein ungültiges Prüfsummenformat verweist.

4. Zu den unterstützten ENS-TLDs gehören .eth, .xyz und .luxe; .com und .org werden nur verarbeitet, wenn sie in ENS-kompatiblen Resolvern registriert sind.

5. PayPal- und Venmo-Integrationen ermöglichen PYUSD-Überweisungen unter Verwendung von ENS-Namen, aber Kontostandsprüfungen bleiben kettennativ und spiegeln keine Zahlungssalden außerhalb der Kette wider.

Häufig gestellte Fragen

F: Kann ich Guthaben für Wallets auf nicht unterstützten Ketten wie Cardano oder Avalanche überprüfen? A: Nein. Der Endpunkt unterstützt nur Solana, Ethereum, Base, BSC, Polygon, Hedera und Bitcoin. Anfragen für andere Ketten geben HTTP 400 mit dem Fehlercode „unsupported_chain“ zurück.

F: Erkennt die API verpackte Token wie wBTC oder wETH in Ethereum-Wallets? A: Ja. Verpackte Token, die den ERC-20-Standards entsprechen, werden im Token-Array mit korrektem Symbol, Dezimalstellen und Rohguthaben angezeigt.

F: Was passiert, wenn ein Wallet über alle Vermögenswerte hinweg einen Nullsaldo aufweist? A: Die Antwort enthält den Kontostand „0“ und ein leeres Token -Array. Der HTTP-Status bleibt 200.

F: Gibt es eine Möglichkeit, mehrere Adressen in einer Anfrage stapelweise zu prüfen? A: Nicht nativ. Für jede Adresse ist eine separate HTTP-Anfrage erforderlich. Clients müssen Parallelisierungs- oder Warteschlangenlogik extern implementieren.