API explorer Polygon: PolygonScan, Blockscout, endpoint RPC, dan explorer kit

API explorer Polygon memberi kode Anda data yang sama dengan yang Anda lihat di halaman explorer: transaksi, saldo, token transfer, blok, dan ABI kontrak. Ada tiga pilihan utama, yaitu Etherscan API V2 (data PolygonScan, wajib key), API Blockscout (open source, tanpa key untuk pemakaian sedang), dan JSON-RPC mentah dari node Polygon, ditambah REST API Heimdall untuk checkpoint dan validator.

Kami memakai sebagian besar API ini setiap hari: explorer Polygon live kami sepenuhnya berjalan di atas Blockscout API v2 dan endpoint RPC publik, yang dipanggil langsung dari browser Anda. Setiap endpoint dan contoh kode di halaman ini dijalankan tim kami pada 25 September 2026 sebelum diterbitkan. Jika ada yang tidak bisa kami verifikasi, kami menyebutkannya dengan jelas.

API Polygon mana yang sebaiknya Anda pakai?

Pilihan yang tepat tergantung apa yang sedang Anda bangun. Berikut perbandingan praktisnya.

Patokan dari pekerjaan kami sendiri: jika Anda butuh “riwayat”, seperti semua token transfer sebuah alamat atau daftar holder, Anda butuh indexer, artinya Etherscan atau Blockscout. Node RPC biasa tidak bisa menjawab “tampilkan semua transaksi yang pernah dilakukan dompet ini” secara efisien. Jika Anda butuh “state saat ini” atau ingin mengirim transaksi, RPC adalah jalur langsungnya. Untuk perbandingan dari sisi pengguna tentang explorer di balik API ini, lihat peringkat explorer Polygon terbaik kami.

API PolygonScan: Etherscan API V2 dan API key Anda

PolygonScan dibangun oleh tim Etherscan, dan API-nya sudah digabungkan ke dalam Etherscan API V2. Alih-alih key PolygonScan terpisah dan api.polygonscan.com, kini Anda memakai satu key Etherscan untuk semua chain yang didukung dan memilih chain lewat parameter chainid. Untuk Polygon PoS nilainya chainid=137.

Kami mengecek host lama: api.polygonscan.com sekarang merespons dengan redirect, jadi perbarui kode lama Anda. Tanpa key, endpoint baru menjawab dengan sopan tetapi menolak:

# Cek saldo tanpa API key (akan ditolak)
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"}

Tambahkan &apikey=YOUR_KEY dan panggilan yang sama mengembalikan saldo dalam wei. Nama module dan action (account, txlist, tokentx, contract, getabi, proxy, dan lainnya) adalah nama klasik Etherscan, jadi tutorial bertahun-tahun masih berlaku setelah Anda mengganti base URL dan menambahkan chainid.

Cara mendapatkan API key PolygonScan: buat akun gratis di Etherscan, buka bagian API keys di dashboard, lalu buat key baru. Paket gratis datang dengan batas per detik dan per hari. Etherscan sudah lebih dari sekali mengubah chain dan endpoint yang dicakup paket gratis, jadi cek halaman paket terbaru di dokumentasi API Etherscan sebelum Anda mengandalkannya untuk sebuah produk. Ulasan PolygonScan kami membahas sisi explorer dari akun tersebut (watchlist, notifikasi, ekspor CSV).

API Blockscout untuk Polygon PoS (tanpa key)

Blockscout adalah explorer open source yang menjalankan instance Polygon PoS di polygon.blockscout.com, dan menawarkan dua API di host yang sama. Keduanya tidak memerlukan key dalam pengujian kami, dan keduanya mengembalikan Access-Control-Allow-Origin: *.

REST API v2

API JSON modernnya ada di https://polygon.blockscout.com/api/v2/. API ini mengembalikan objek yang kaya dan sudah di-decode: metadata token beserta harga, nama method yang sudah di-decode, dan rincian biaya. Endpoint yang terus kami pakai:

• /transactions/{hash} — status, blok, konfirmasi, biaya, method, input yang sudah di-decode
• /addresses/{address} — saldo, penanda kontrak, nama, status verifikasi
• /addresses/{address}/token-balances — semua saldo ERC-20, ERC-721, dan ERC-1155
• /blocks/{number} — gas terpakai dan batas gas, base fee, biaya yang di-burn
• /tokens/{address} — nama, simbol, desimal, holder, harga
• /stats — penghitung seluruh jaringan, harga gas, rata-rata waktu blok

# Ambil data token USDC native di Polygon
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", "...": "..."}

Perhatikan bahwa angka dikirim sebagai string (untuk menghindari hilangnya presisi di JavaScript) dan jumlah token dinyatakan dalam satuan terkecil token tersebut. Bagi dengan 10 ** decimals sebelum menampilkannya.

API yang kompatibel dengan Etherscan

Di https://polygon.blockscout.com/api, Blockscout meniru gaya query module/action milik Etherscan. Ini menjadikannya pengganti langsung ketika Anda punya kode bergaya Etherscan dan tidak mau memakai key:

# Cek status receipt transaksi lewat API gaya Etherscan milik Blockscout
curl -s "https://polygon.blockscout.com/api?module=transaction&action=gettxreceiptstatus&txhash=0x9ba51db95824c1677415608326cefc1620c4c835dc0dbe8612a6b7674942b24b"
# {"message":"OK","result":{"status":"1"},"status":"1"}

Cakupannya tidak identik dengan Etherscan; beberapa action tidak ada atau berperilaku sedikit berbeda, jadi uji setiap panggilan yang Anda andalkan. Dokumentasi API Blockscout mencantumkan apa saja yang didukung. Untuk explorer-nya sendiri, baca ulasan Blockscout lengkap kami.

Endpoint RPC Polygon publik (daftar teruji)

JSON-RPC adalah cara dompet dan dApp berbicara langsung dengan node Polygon: eth_blockNumber, eth_getBalance, eth_call, eth_sendRawTransaction, dan seterusnya. Berikut hasil yang kami pastikan pada 25 September 2026 dengan memanggil eth_chainId di setiap endpoint menggunakan header Origin ala browser.

Pengecekan cepat yang bisa Anda jalankan dari terminal mana pun:

# Pastikan endpoint mengembalikan chain ID Polygon PoS
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 adalah 137, mainnet Polygon PoS. Setiap endpoint publik membuka metode yang berbeda: txpool_status berfungsi di publicnode, tetapi dRPC menolaknya sebagai tidak tersedia. Untuk menambahkan endpoint ini ke dompet dengan chain ID, mata uang, dan URL explorer yang benar, lihat halaman pengaturan jaringan Polygon kami; dokumentasi Polygon sendiri menyimpan daftar penyedia RPC, termasuk yang berbayar dengan SLA.

REST API Heimdall untuk checkpoint dan validator

Lapisan konsensus Polygon punya API publik sendiri di https://heimdall-api.polygon.technology. Dari sinilah Anda mendapatkan data checkpoint dan validator yang tidak disediakan API explorer EVM mana pun: /checkpoints/latest, /checkpoints/count, /checkpoints/{id}, /milestones/latest, /stake/validators-set, dan /stake/validator/{id}. Tanpa key, CORS terbuka. Bentuk respons berubah dengan upgrade Heimdall v2 pada Juli 2025, dan root hash kini dalam Base64, jadi parser lama mungkin perlu diperbarui. Kami mendokumentasikan endpoint ini beserta output live-nya di explorer checkpoint Heimdall, yang memakai panggilan yang persis sama.

Contoh siap pakai di browser dengan fetch

Berikut skrip kecil yang membaca saldo USDC sebuah dompet dari Blockscout dan blok terbaru dari RPC publik. Skrip ini berjalan tanpa perubahan di console browser modern atau di Node 18+, dan sudah kami jalankan sebelum terbit:

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

// Ambil semua saldo token dompet dari Blockscout API v2
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();

// Cari USDC berdasarkan alamat kontrak, lalu konversi dengan desimal token
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}`);

// Ambil nomor blok terbaru lewat JSON-RPC publik
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));

Dompet dalam contoh ini adalah kontrak WPOL, yang masih dilabeli “WMATIC” oleh Blockscout. Ini pengingat bagus bahwa nama dalam respons API bisa tertinggal dari rebranding. Selalu dasarkan logika Anda pada alamat, bukan nama atau simbol. Untuk kode produksi, gunakan BigInt atau library desimal alih-alih Number untuk jumlah token; saldo besar kehilangan presisi jika disimpan sebagai angka floating-point.

Batas rate, CORS, dan menjalankan di browser

Batas rate. Setiap API gratis di sini dibatasi rate. Blockscout mengirim header x-ratelimit-limit, x-ratelimit-remaining, dan x-ratelimit-reset di setiap respons; dalam pengujian kami, header limit menunjukkan angka 180. Baca header itu dan beri jeda, jangan membanjiri server. Etherscan menerapkan batas per key per detik dan per hari. RPC publik membatasi berdasarkan IP tanpa memberi tahu angkanya. Gunakan cache secara agresif: transaksi yang sudah terkonfirmasi tidak akan pernah berubah, jadi cukup ambil sekali.

CORS. Blockscout, REST Heimdall, dan tiga RPC publik yang berfungsi semuanya mengembalikan Access-Control-Allow-Origin: *. Itulah sebabnya situs statis seperti milik kami bisa memanggilnya dari browser pengunjung. API Etherscan juga mengembalikan header CORS terbuka, tetapi itu tidak membuatnya aman dipanggil dari front end.

Cadangan. Infrastruktur publik bisa down. Explorer kami mencoba Blockscout terlebih dahulu dan beralih ke beberapa endpoint RPC jika salah satunya gagal; kami menyarankan pola yang sama untuk aplikasi apa pun yang bergantung pada endpoint gratis.

Polygon explorer kit: membangun atau meng-host explorer sendiri

“Polygon explorer kit” adalah frasa yang dicari orang ketika ingin menjalankan explorer, bukan sekadar memakainya, entah untuk chain berbasis Polygon yang mereka operasikan, dashboard internal, atau sekadar menghindari batas rate pihak ketiga. Tidak ada satu produk resmi dengan nama itu. Dalam praktiknya, artinya merakit:

Bagi sebagian besar tim, meng-host sendiri explorer Polygon PoS yang lengkap tidak sepadan, karena instance publik Blockscout dan PolygonScan sudah mengindeks miliaran transaksi. Self-hosting masuk akal untuk chain baru, jaringan privat, atau ketika Anda butuh kapasitas yang terjamin. Dokumentasi deployment Blockscout dan repositori GitHub-nya adalah titik awalnya.

Jika Anda membangun sesuatu yang memindahkan dana sungguhan dan hanya butuh POL untuk gas saat menguji di mainnet, belilah di exchange teregulasi yang memegang lisensi di beberapa yurisdiksi dan memungkinkan penarikan langsung ke jaringan Polygon, dan pilih Polygon PoS sebagai jaringan penarikan. Developer di Indonesia sebaiknya juga mengikuti ketentuan terbaru dari OJK, yang kini mengawasi aset kripto. Untuk dana uji coba gratis, gunakan faucet Amoy yang dijelaskan di halaman explorer testnet Amoy kami.

Cara alat live kami memakai API ini

Explorer transaksi dan alamat Polygon kami adalah contoh nyata dari semua hal di atas. Pencarian transaksi, alamat, blok, dan token di Polygon PoS diarahkan ke Blockscout API v2; jika pencarian gagal atau transaksinya masih sangat baru, alat kami beralih ke JSON-RPC lewat endpoint publik yang tercantum di sini. Pencarian Amoy dan zkEVM memakai data RPC dasar. Widget pelacak gas dan mempool membaca RPC secara langsung, sedangkan widget Heimdall memanggil REST Heimdall. Tanpa API key, tanpa backend, dan tidak ada yang disimpan di sisi kami: permintaan dikirim langsung dari browser Anda ke API publik. Itu juga sebabnya, jika salah satu penyedia sedang gangguan, Anda mungkin sesekali melihat tanda strip di tempat yang seharusnya berisi angka.