Etherscan · Markets

Etherscan / ERC-20 token balance of an address

Balance of one ERC-20 token (raw units, divide by the token's decimals) held by an address. Runs on your own Etherscan API key; Etherscan bills your own plan (the free plan has rate limits and does not cover every chain). looot charges $0.

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

action query · optional
Fixed to "tokenbalance" for this route.
address query · required
A 0x address, e.g. 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae.
chainid query · optional
EVM chain id: 1 Ethereum, 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Chain, 11155111 Sepolia. Default 1. Some chains need a paid Etherscan plan.
contractaddress query · required
Token contract, e.g. USDC 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.
module query · optional
Fixed to "account" for this route.
tag query · optional
Fixed to latest.

No allowlisted official documentation or pricing reference is available.