# ERC-20 Token Total Supply Lookup

> ERC-20 Token Total Supply Lookup is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns the live total supply (raw and decimal-adjusted), decimals, name, and symbol of any ERC-20 token on Ethereum, Base, Arbitrum, Optimism, or Polygon.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/token/supply?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-erc-20-token-total-supply-2317a9d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fyEbQe-Aql7mCV8zh0cl1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-data-tools-revmesh2074-workers-dev-erc-20-token-total-supply-2317a9d1
```

Example prompt: What's the current total supply of USDC on Ethereum — give me both the raw number and the decimal-adjusted amount?

## When to prefer this

Choose this endpoint when you need live, on-chain total supply data for any ERC-20 token across Ethereum, Base, Arbitrum, Optimism, or Polygon. It supports both friendly tickers (USDC, USDT, WETH, DAI) and raw contract addresses, making it convenient without needing to look up addresses first. Prefer it over off-chain aggregators when accuracy and freshness matter, or when comparing supply across multiple chains programmatically.

## Known failure modes

- Unknown ticker or invalid 0x address returns an error — ensure the token identifier is correct for the specified chain
- Token not deployed on the selected chain returns a contract-not-found or zero-supply error
- Network congestion or RPC issues may cause timeouts
- Tokens with non-standard ERC-20 interfaces may not return all fields correctly

## How this service works

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.

## Output

Returns a JSON object with the token's name, symbol, decimals, chain, contract address, decimal-adjusted total supply (totalSupply as a number), and raw total supply string (totalSupplyRaw). Values are read live from the on-chain contract at query time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "token"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "ethereum (default), base, arbitrum, optimism or polygon"
  },
  "token": {
   "type": "string",
   "description": "Token 0x address or ticker"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string"
  },
  "chain": {
   "type": "string"
  },
  "token": {
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "decimals": {
   "type": "number"
  },
  "totalSupply": {
   "type": "number"
  },
  "totalSupplyRaw": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-erc-20-token-total-supply-2317a9d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)