Polygon Explorer API: PolygonScan, Blockscout, RPC-Endpunkte und Explorer-Kits

Eine Polygon Explorer API liefert Ihrem Code dieselben Daten, die Sie auf einer Explorer-Seite sehen: Transaktionen, Guthaben, Token-Transfers, Blöcke, Contract-ABIs. Sie haben drei Hauptoptionen – die Etherscan API V2 (Daten von PolygonScan, Key erforderlich), die API von Blockscout (Open Source, bei moderater Nutzung ohne Key) und reines JSON-RPC von einem Polygon-Node –, dazu die REST API von Heimdall für Checkpoints und Validatoren.

Die meisten davon nutzen wir täglich: Unser eigener Live-Explorer für Polygon läuft komplett auf Blockscout API v2 und öffentlichen RPC-Endpunkten, die direkt aus Ihrem Browser aufgerufen werden. Jeden Endpunkt und jedes Codebeispiel auf dieser Seite hat unser Team am 25. September 2026 vor der Veröffentlichung ausgeführt. Wo wir etwas nicht verifizieren konnten, sagen wir das.

Welche Polygon API sollten Sie nutzen?

Die richtige Wahl hängt davon ab, was Sie bauen. So schneiden die Optionen in der Praxis ab:

Eine Faustregel aus unserer eigenen Arbeit: Brauchen Sie „Historie“ – alle Token-Transfers einer Adresse, eine Holder-Liste –, brauchen Sie einen Indexer, also Etherscan oder Blockscout. Reine RPC-Nodes können die Frage „Zeig mir jede Transaktion, die dieses Wallet je gemacht hat“ nicht effizient beantworten. Brauchen Sie den „aktuellen Zustand“ oder wollen Sie eine Transaktion absenden, ist RPC der direkte Weg. Einen Vergleich der Explorer hinter diesen APIs aus Nutzersicht finden Sie in unserem Ranking der besten Polygon Explorer.

PolygonScan API: Etherscan API V2 und Ihr API-Key

PolygonScan wird vom Etherscan-Team entwickelt, und seine API ist in der Etherscan API V2 aufgegangen. Statt eines eigenen PolygonScan-Keys und api.polygonscan.com nutzen Sie jetzt einen einzigen Etherscan-Key für alle unterstützten Chains und wählen die Chain über den Parameter chainid. Für Polygon PoS ist das chainid=137.

Wir haben den alten Host geprüft: api.polygonscan.com antwortet inzwischen mit einer Weiterleitung – aktualisieren Sie also Ihren Altcode. Ohne Key antwortet der neue Endpunkt höflich, verweigert aber die Daten:

curl -s "https://api.etherscan.io/v2/api?chainid=137&module=account&action=balance&address=0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270&tag=latest"
# {"status":"0","message":"NOTOK","result":"Missing/Invalid API Key"}

Hängen Sie &apikey=YOUR_KEY an, liefert derselbe Aufruf das Guthaben in Wei. Die Modul- und Aktionsnamen (account, txlist, tokentx, contract, getabi, proxy usw.) sind die klassischen von Etherscan. Jahrelang gesammelte Tutorials gelten also weiterhin, sobald Sie die Basis-URL umstellen und chainid ergänzen.

So bekommen Sie einen PolygonScan API-Key: Legen Sie ein kostenloses Konto bei Etherscan an, öffnen Sie im Dashboard den Bereich für API-Keys und erzeugen Sie einen Key. Der Gratis-Tarif hat Limits pro Sekunde und pro Tag. Etherscan hat mehr als einmal angepasst, welche Chains und Endpunkte der Gratis-Tarif abdeckt – prüfen Sie daher die aktuelle Tarifseite in der Etherscan-API-Dokumentation, bevor Sie ein Produkt darauf aufbauen. Die Explorer-Seite des Kontos (Watchlists, Benachrichtigungen, CSV-Export) behandelt unser PolygonScan-Test.

Blockscout API für Polygon PoS (ohne Key)

Blockscout ist der Open-Source-Explorer hinter der Polygon-PoS-Instanz unter polygon.blockscout.com und bietet auf demselben Host zwei APIs an. Keine davon verlangte in unseren Tests einen Key, und beide lieferten Access-Control-Allow-Origin: *.

REST API v2

Die moderne JSON-API finden Sie unter https://polygon.blockscout.com/api/v2/. Sie liefert reichhaltige, bereits dekodierte Objekte: Token-Metadaten mit Kursen, dekodierte Methodennamen, aufgeschlüsselte Gebühren. Endpunkte, die wir ständig nutzen:

• /transactions/{hash} – Status, Block, Bestätigungen, Gebühr, Methode, dekodierter Input
• /addresses/{address} – Guthaben, Contract-Kennzeichen, Name, Verifizierungsstatus
• /addresses/{address}/token-balances – jedes ERC-20-, ERC-721- und ERC-1155-Guthaben
• /blocks/{number} – verbrauchtes Gas und Limit, Base Fee, verbrannte Gebühren
• /tokens/{address} – Name, Symbol, Dezimalstellen, Holder, Kurs
• /stats – netzwerkweite Zähler, Gaspreise, durchschnittliche Blockzeit

curl -s https://polygon.blockscout.com/api/v2/tokens/0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359

{"address_hash":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","decimals":"6","exchange_rate":"0.999859","holders_count":"4165554","name":"USDC","reputation":"ok","symbol":"USDC","type":"ERC-20", "...": "..."}

Beachten Sie, dass Zahlen als Strings ankommen (um Genauigkeitsverluste in JavaScript zu vermeiden) und Beträge in der kleinsten Einheit des Tokens angegeben sind. Teilen Sie sie durch 10 ** decimals, bevor Sie sie anzeigen.

Etherscan-kompatible API

Unter https://polygon.blockscout.com/api ahmt Blockscout den Abfragestil von Etherscan mit module/action nach. Das macht die API zur direkten Alternative, wenn Sie Code im Etherscan-Stil haben und keinen Key wollen:

curl -s "https://polygon.blockscout.com/api?module=transaction&action=gettxreceiptstatus&txhash=0x9ba51db95824c1677415608326cefc1620c4c835dc0dbe8612a6b7674942b24b"
# {"message":"OK","result":{"status":"1"},"status":"1"}

Der Funktionsumfang ist nicht identisch mit dem von Etherscan – manche Aktionen fehlen oder verhalten sich leicht anders –, testen Sie also jeden Aufruf, auf den Sie sich verlassen. Was unterstützt wird, listet die API-Dokumentation von Blockscout. Zum Explorer selbst lesen Sie unseren ausführlichen Blockscout-Test.

Öffentliche Polygon-RPC-Endpunkte (getestete Liste)

Über JSON-RPC sprechen Wallets und dApps direkt mit einem Polygon-Node: eth_blockNumber, eth_getBalance, eth_call, eth_sendRawTransaction und so weiter. Das haben wir am 25. September 2026 bestätigt, indem wir auf jedem Endpunkt eth_chainId mit einem Origin-Header wie aus dem Browser aufgerufen haben:

Ein schneller Plausibilitätstest, den Sie in jedem Terminal ausführen können:

curl -s https://polygon-bor-rpc.publicnode.com \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
# {"jsonrpc":"2.0","result":"0x89","id":1}

0x89 entspricht 137, also dem Polygon-PoS-Mainnet. Öffentliche Endpunkte unterscheiden sich darin, welche Methoden sie anbieten: txpool_status funktionierte bei publicnode, dRPC lehnte die Methode als nicht verfügbar ab. Wie Sie diese Endpunkte mit der richtigen Chain ID, Währung und Explorer-URL in ein Wallet eintragen, zeigt unsere Seite zu den Polygon Netzwerk-Einstellungen. Die Polygon-Dokumentation führt außerdem eine Liste von RPC-Anbietern, darunter kostenpflichtige mit SLA.

Heimdall REST API für Checkpoints und Validatoren

Die Konsensschicht von Polygon hat eine eigene öffentliche API unter https://heimdall-api.polygon.technology. Dort bekommen Sie Checkpoint- und Validator-Daten, die keine EVM-Explorer-API liefert: /checkpoints/latest, /checkpoints/count, /checkpoints/{id}, /milestones/latest, /stake/validators-set und /stake/validator/{id}. Kein Key, CORS offen. Mit dem Upgrade auf Heimdall v2 im Juli 2025 hat sich das Antwortformat geändert – Root-Hashes sind jetzt Base64-kodiert –, ältere Parser brauchen also womöglich ein Update. Die Endpunkte samt Live-Ausgabe dokumentieren wir auf unserem Heimdall-Checkpoint-Explorer, der genau diese Aufrufe nutzt.

Ein Browser-taugliches Beispiel mit fetch

Hier ein kleines Skript, das das USDC-Guthaben eines Wallets bei Blockscout und den neuesten Block über einen öffentlichen RPC abfragt. Es läuft unverändert in der Konsole eines modernen Browsers oder in Node 18+, und wir haben es vor der Veröffentlichung ausgeführt:

const USDC = '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359';
const wallet = '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270';

const res = await fetch(`https://polygon.blockscout.com/api/v2/addresses/${wallet}/token-balances`);
if (!res.ok) throw new Error(`Blockscout returned ${res.status}`);
const balances = await res.json();

const usdc = balances.find(b => b.token.address_hash.toLowerCase() === USDC.toLowerCase());
const amount = usdc ? Number(usdc.value) / 10 ** Number(usdc.token.decimals) : 0;
console.log(`USDC balance: ${amount}`);

const rpc = await fetch('https://polygon-bor-rpc.publicnode.com', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'eth_blockNumber', params: [] }),
});
const { result } = await rpc.json();
console.log('Latest block:', parseInt(result, 16));

Das Wallet im Beispiel ist der WPOL-Contract, den Blockscout noch immer als „WMATIC“ bezeichnet – eine schöne Erinnerung daran, dass Namen in API-Antworten einem Rebranding hinterherhinken können. Knüpfen Sie Ihre Logik immer an Adressen, nicht an Namen oder Symbole. Für produktiven Code verwenden Sie für Token-Beträge BigInt oder eine Dezimal-Bibliothek statt Number; große Guthaben verlieren als Gleitkommazahlen an Genauigkeit.

Ratenlimits, CORS und der Betrieb im Browser

Ratenlimits. Jede kostenlose API hier ist begrenzt. Blockscout sendet bei jeder Antwort die Header x-ratelimit-limit, x-ratelimit-remaining und x-ratelimit-reset – in unserem Test stand im Limit-Header 180. Lesen Sie diese Werte aus und drosseln Sie Ihre Anfragen, statt den Server zu überlasten. Etherscan setzt Limits pro Key und Sekunde sowie pro Tag durch. Öffentliche RPCs drosseln nach IP, ohne die Zahlen zu verraten. Cachen Sie großzügig: Eine bestätigte Transaktion ändert sich nie, rufen Sie sie also nur einmal ab.

CORS. Blockscout, Heimdall REST und die drei funktionierenden öffentlichen RPCs lieferten alle Access-Control-Allow-Origin: *. Deshalb kann eine rein statische Website wie unsere sie aus dem Browser des Besuchers abfragen. Auch die API von Etherscan lieferte einen offenen CORS-Header – sicher wird der Aufruf aus dem Frontend dadurch aber nicht.

Fallbacks. Öffentliche Infrastruktur fällt aus. Unser Explorer versucht es zuerst bei Blockscout und weicht bei einem Fehler auf mehrere RPC-Endpunkte aus. Dasselbe Muster empfehlen wir für jede App, die von kostenlosen Endpunkten abhängt.

Polygon Explorer Kit: einen eigenen Explorer bauen oder hosten

„Polygon Explorer Kit“ suchen Menschen, die einen Explorer betreiben statt nur nutzen wollen – für eine eigene Polygon-basierte Chain, für ein internes Dashboard oder schlicht, um den Ratenlimits von Drittanbietern zu entgehen. Ein einzelnes offizielles Produkt dieses Namens gibt es nicht. In der Praxis stellen Sie Folgendes zusammen:

Für die meisten Teams lohnt es sich nicht, einen vollständigen Polygon-PoS-Explorer selbst zu hosten – die öffentlichen Instanzen von Blockscout und PolygonScan indexieren bereits Milliarden von Transaktionen. Sinnvoll ist es für neue Chains, private Netzwerke oder wenn Sie garantierte Kapazität brauchen. Einstiegspunkte sind die Deployment-Dokumentation von Blockscout und das GitHub-Repository.

Bauen Sie etwas, das echtes Geld bewegt, und brauchen Sie für Tests im Mainnet nur etwas POL für Gas, kaufen Sie es bei einer regulierten Börse mit Lizenzen in mehreren Rechtsräumen, die direkte Auszahlungen ins Polygon-Netzwerk erlaubt – wählen Sie Polygon PoS als Auszahlungsnetzwerk. Planen Sie ein Produkt für Kunden in der EU, sollten Sie außerdem die Anforderungen der MiCA-Verordnung kennen; Informationen dazu bietet die BaFin. Für kostenlose Test-Token nutzen Sie stattdessen den Amoy-Faucet, den wir auf unserer Seite zum Amoy-Testnet-Explorer beschreiben.

So nutzt unser Live-Tool diese APIs

Unser Polygon-Transaktions- und Adress-Explorer ist ein funktionierendes Beispiel für alles oben Beschriebene. Abfragen zu Transaktionen, Adressen, Blöcken und Token auf Polygon PoS gehen an Blockscout API v2; schlägt eine Abfrage fehl oder ist sie sehr frisch, weicht das Tool auf JSON-RPC über die hier gelisteten öffentlichen Endpunkte aus. Abfragen für Amoy und zkEVM nutzen einfache RPC-Daten. Gas Tracker und Mempool-Widget lesen RPC direkt, das Heimdall-Widget ruft Heimdall REST auf. Kein API-Key, kein Backend, nichts wird bei uns gespeichert – die Anfragen gehen direkt von Ihrem Browser an die öffentlichen APIs. Deshalb sehen Sie bei einem Ausfall eines dieser Anbieter auch kurzzeitig einen Strich, wo eigentlich eine Zahl stehen sollte.