# ERC20 Token Supply & Info Lookup

> ERC20 Token Supply & Info Lookup is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-16).

Returns total supply, name, symbol, and decimals for any ERC20 token contract on Ethereum, Base, Arbitrum, Optimism, or Polygon

## Facts

- Endpoint: GET https://api.x402node.dev/chain/erc20-supply
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc20-token-supply-info-lookup-350631f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o6gbhfQZr9omn-MYrilsg

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 erc20-token-supply-info-lookup-350631f3
```

Example prompt: What's the total supply, symbol, and decimals for the ERC20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet?

## When to prefer this

Use this endpoint when you need on-chain ERC20 metadata — total supply, name, symbol, or decimals — for a token on Ethereum, Base, Arbitrum, Optimism, or Polygon, without needing price data or off-chain market information. Prefer this over CoinGecko-style endpoints when you have a contract address and need raw supply data directly from the contract.

## Known failure modes

- Invalid or non-existent contract address returns an error
- Contract address is not an ERC20 token (e.g. ERC721 or EOA) returns an error or null fields
- Unsupported chain ID returns an error
- RPC node unavailability causes timeout or 5xx error
- Malformed address format returns a 400 bad request

## How this service works

Total supply, name, symbol and decimals for any ERC20 token contract on Ethereum, Base, Arbitrum, Optimism or Polygon. token supply, erc20 total supply, circulating supply, token info, coin supply Accepts payment on Base or Solana — either network works.

## Output

Returns a JSON object with the token's total supply (as a raw and/or human-readable number), token name, ticker symbol, and decimal precision — all read directly from the ERC20 contract on the specified chain.

## Example request

```json
{
 "chain": "ethereum",
 "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "ethereum, base (default), arbitrum, optimism, polygon"
      },
      "token": {
       "type": "string",
       "description": "ERC20 contract address (optional)"
      },
      "address": {
       "type": "string",
       "description": "ERC20 contract address (required)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc20-token-supply-info-lookup-350631f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)