ERC20-Adresse: Format, balanceOf und Erstellung per API
Eine ERC20-Adresse ist die 42 Zeichen lange Kontoadresse mit Präfix 0x, die Ethereum für jede Wallet verwendet. Sie wird zur ERC-20-Adresse, wenn das Konto Token nach dem ERC-20-Standard hält. Derselbe String funktioniert auf Polygon und Arbitrum, weil beide EVM-kompatibel sind, doch Token und Guthaben gelten jeweils nur für eine Chain.
Ein ERC-20-Guthaben liefert der Aufruf von balanceOf(address) am Token-Contract. Über REST gibt GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} denselben Wert bereits dekodiert zurück. Um Token zu empfangen, geben Sie die Adresse weiter. Um sie zu senden, brauchen Sie den zugehörigen Key und etwas ETH für das Gas.
Diese Seite behandelt das Adressformat, balanceOf, dieselbe Adresse auf Polygon und Arbitrum und das Erstellen von Adressen per REST.
Was ist der ERC-20-Standard?
ERC-20 ist die Standardschnittstelle für fungible Token auf Ethereum. EIP-20 definiert sechs Funktionen: totalSupply, balanceOf, transfer, transferFrom, approve und allowance, dazu die Events Transfer und Approval. Jeder Contract, der sie implementiert, ist ein konformes Token. Wallets und Börsen können ein neues Token daher ohne Sonderarbeit je Token unterstützen.
Die ERC-20-Übersicht von ethereum.org führt dieselbe Schnittstelle mit Beispielen vor. Die ganze Mechanik steht in unserem Artikel zum ERC20-Token-Standard. Diese Seite bleibt bei der Adresse: was eine ERC-20-Adresse ist und wie Sie im Code damit arbeiten.
Wie sieht eine ERC-20-Adresse aus?
Eine ERC-20-Adresse ist die gewöhnliche Ethereum-Adresse, zum Beispiel 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed. Sie besteht aus 0x und 40 hexadezimalen Zeichen, insgesamt also 42 Zeichen. Die Konten-Dokumentation von ethereum.org beschreibt sie als die letzten 20 Byte des Keccak-256-Hashes des Public Keys des Kontos.
Der Name taucht nur im Zusammenhang auf. Eine Adresse wird zur „ERC-20-Adresse“, wenn es um die Token geht, die sie hält. Dem String sieht man nicht an, ob er Token halten kann. Dieselbe Adresse funktioniert für ETH, für jedes ERC-20-Token und für NFTs.
- Das Präfix 0x kennzeichnet den Wert als hexadezimal.
- Die 40 Hexadezimalzeichen sind 20 Byte: die letzten 20 Byte des Keccak-256-Hashes des Public Keys.
- Insgesamt 42 Zeichen. Die Mischung aus Groß- und Kleinbuchstaben ist die EIP-55-Prüfsumme.
Wie liest balanceOf ein ERC-20-Guthaben aus?
balanceOf(address) ist die schreibgeschützte Funktion, die das Token-Guthaben einer Adresse zurückgibt. Das Guthaben liegt nicht in der Adresse. Es steht im Smart Contract des Tokens, in einer nach Adresse geordneten Zuordnung, und balanceOf schlägt es dort nach.
Wer die Funktion direkt aufruft, muss einen JSON-RPC-Aufruf eth_call an den Token-Contract kodieren und das zurückgegebene Hex dekodieren. Das Ergebnis ist eine Ganzzahl in der kleinsten Einheit des Tokens, daher müssen Sie auch decimals() lesen. Viele Stablecoins nutzen 6 Dezimalstellen, andere 18. Ein Fehler an dieser Stelle ist eine häufige Quelle für Bugs um den Faktor eine Million.
Die Chaingateway-API übernimmt Kodierung und Dezimalstellen für Sie. Die Balance-Endpoints liefern einfache Zahlen, aus einem Raw-RPC-Problem wird so eine normale REST-Antwort.
Gilt dieselbe ERC-20-Adresse auf Polygon und Arbitrum?
Ja. Polygon und Arbitrum sind EVM-kompatibel, ihre Adressen haben daher exakt das 0x-Format. Eine Adresse, die aus demselben Private Key abgeleitet wird, ist auf Ethereum, Polygon und Arbitrum derselbe String.
Die Token an dieser Adresse sind dagegen nicht gemeinsam. Ein Token-Contract, der auf Ethereum liegt, existiert auf Polygon erst, wenn jemand ihn dort deployt oder das Asset überbrückt. Guthaben sind also chain-spezifisch, auch wenn die Adresse es nicht ist. Token auf Polygon folgen derselben ERC-20-Schnittstelle, deshalb kann ein Codepfad alle drei Chains bedienen.
ERC-721 und ERC-721A: anderer Standard, gleiches Adressformat
ERC-721 ist der Standard für nicht fungible Token auf Ethereum. Jede Token-ID ist einzigartig, anders als die austauschbaren Guthaben bei ERC-20. EIP-721 legt die Schnittstelle fest.
ERC-721A ist eine gasoptimierte Implementierung derselben Schnittstelle, beliebt bei Kollektionen, die im Batch geprägt werden. Sie ändert, wie der Contract Daten intern speichert, nicht, wie die Adresse eines Inhabers aussieht. Beide Standards nutzen dieselbe 0x-Adresse für den Besitz. Die NFT-Seite behandelt der Artikel zum ERC721-Token-Standard ausführlich.
ERC-20-Adressen per REST erstellen und lesen
Sechs Routen decken den Adresslebenszyklus einer Zahlungsintegration ab.
| Endpoint | Was er tut |
|---|---|
POST /api/v2/ethereum/addresses | Neue Ethereum-Adresse generieren |
POST /api/v2/ethereum/addresses/import | Private Key importieren, damit die API für diese Adresse signieren kann |
GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} | Guthaben eines ERC-20-Tokens, bereits dekodiert |
GET /api/v2/ethereum/balances/{address}/erc20 | Alle Token-Guthaben der Wallet |
POST /api/v2/ethereum/webhooks | Webhook für ERC-20-Deposits auf die Adresse registrieren |
POST /api/v2/ethereum/transactions/erc20 | Ein ERC-20-Token von der Adresse senden |
Dieselbe Anfrageform gilt mit /polygon/ oder /arbitrum/ statt /ethereum/ im Pfad, denn alle drei Chains teilen Adressformat und ERC-20-Schnittstelle.
ERC-20-Guthaben ohne eth_call lesen
Die Contract-Adresse unten ist USDT auf dem Ethereum-Mainnet. Fügen Sie X-Network: testnet hinzu, um stattdessen ein Testnet-Token abzufragen.
curl https://app.chaingateway.io/api/v2/ethereum/balances/0xYourAddress/erc20/0xdAC17F958D2ee523a2206206994597C13D831ec7 \
-H "Authorization: Bearer YOUR_API_KEY"Wie validiere ich eine ERC-20-Adresse vor dem Senden?
Gleichen Sie den String zuerst mit ^0x[a-fA-F0-9]{40}$ ab, das weist falsche Längen und Fremdzeichen ab. Mischt die Adresse Groß- und Kleinbuchstaben, prüfen Sie zusätzlich die EIP-55-Prüfsumme. Schon ein falscher Buchstabe lässt sie scheitern.
Eine Formatprüfung sagt nicht, welches Netzwerk der Empfänger erwartet, weil dieselbe Adresse auf jeder EVM-Chain gültig ist. Erfragen Sie das Netzwerk ausdrücklich. Akzeptieren Sie nie die Adresse eines Token-Contracts als Ziel. Der Adress-Validator führt die Format- und Prüfsummenprüfung für eine einzelne Adresse im Browser aus.
Quellen
- EIP-20: Token Standard
- ERC-20 token standard (ethereum.org)
- Ethereum accounts (ethereum.org)
- ERC-55: Mixed-case checksum address encoding
Geprüft am 5. November 2026.
Sie wollen ERC-20-Guthaben ohne balanceOf-Aufrufe von Hand zu dekodieren? Erstellen Sie ein kostenloses Konto und fragen Sie eine Testnet-Adresse per REST ab. 7 Tage kostenlos testen, keine Karte, kein KYC.
FAQ: ERC-20-Adressen
Bereit, auf Ethereum, Polygon oder Arbitrum zu bauen?
Erstellen Sie ein Konto und fragen Sie ein ERC-20-Guthaben im Testnet ab. 7 Tage kostenlos testen, keine Karte, kein KYC. Die vollständige Referenz steht in der Doku zur Ethereum-API. Alle sieben Chains deckt die Multi-Chain-Blockchain-API ab.
Geprüft von Maurice Sobiera So entstehen diese Seiten