Beatae error blanditiis libero

Retrieve POL balances, transaction history, and token holdings for any wallet address on the Polygon PoS network.

The Polygon Wallet API (accessed via the account module) is the most commonly used set of endpoints in the Polygon Scan API. It provides everything needed to build a wallet tracker, portfolio application, or compliance tool on the Polygon PoS network.

Checking POL Balance

To retrieve the native POL (formerly MATIC) balance of a Polygon wallet address:

?module=account&action=balance&address=0xWALLET&tag=latest&apikey=KEY

The result is the balance in Wei (1 POL = 10^18 Wei). Divide by 10^18 to get the human-readable POL amount. The tag parameter accepts "latest" (current block), "earliest" (genesis), or a specific block number in hex.

Batch Balance Lookup

The balancemulti action checks up to 20 addresses in a single request, dramatically reducing API calls for portfolio applications:

?module=account&action=balancemulti&address=0xADDR1,0xADDR2,...&tag=latest&apikey=KEY

Historical Balance via Block Number

To query the balance at a specific historical point, replace latest with a block number (in decimal or hex). First, use the block module's getblocknobytime to convert a Unix timestamp to a block number, then query the balance at that block.

Transaction Count (Nonce)

The getminedblocks action retrieves all blocks mined by a specific validator address, useful for staking analytics. For regular wallet addresses, use the txlist action with sort=asc to infer transaction count from the nonce field of the latest transaction.

Combined Wallet Dashboard

A complete wallet dashboard typically combines: balance, tokentx (ERC-20 holdings), tokennfttx (NFT holdings), and txlist (activity feed). Make these calls in parallel using Promise.all in JavaScript or asyncio.gather in Python for the best performance.