Token supply, total supply: any ERC-20

$0.01 per call · failed calls are never charged · no account or API key needed

Total supply of any ERC-20 token on Ethereum, Base, Arbitrum, Optimism or Polygon, read live from the contract: raw and decimal-adjusted supply, decimals, name and symbol. Give a 0x address or a known ticker (USDC, USDT, WETH, DAI…). Use to check a token's circulating maximum or compare supply across chains.

Run it free (25 free calls) Buy credits by card (from $5) Example result (JSON)

Try it with your own inputs

Token 0x address or ticker

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
token (required)stringToken 0x address or ticker
chainstringethereum (default), base, arbitrum, optimism or polygon

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/token/supply?token=USDC"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/token/supply?token=USDC&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "chain": "Base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "name": "USD Coin",
  "symbol": "USDC",
  "decimals": 6,
  "totalSupply": 4100000000.5,
  "totalSupplyRaw": "4100000000500000"
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is token_supply, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools