# ERC20/ERC721 Total Supply Lookup

> ERC20/ERC721 Total Supply Lookup is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-12).

Returns the total supply of an ERC20 or ERC721 token on a given EVM chain, formatted with decimals and symbol, via eth_call totalSupply.

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/chain/total-supply?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc20-erc721-total-supply-lookup-76112fc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bwS80K1GORuw8x2a2HD_3

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-erc721-total-supply-lookup-76112fc6
```

Example prompt: What is the total supply of the USDC token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, with the symbol and decimal formatting?

## When to prefer this

Use this endpoint when you need to quickly retrieve the on-chain total supply of any ERC20 or ERC721 token across Base, Ethereum, Arbitrum, Optimism, or Polygon without running your own node. It is ideal for DeFi research, token analytics, NFT collection audits, or any workflow that needs supply data formatted with the correct decimals and symbol in a single cheap call ($0.001).

## Known failure modes

- Invalid or non-checksummed token contract address returns an error
- Contract address does not implement totalSupply (not ERC20/ERC721) returns a call revert or null
- Unsupported chain value returns a validation error
- Network congestion or RPC timeout may cause delayed or failed eth_call
- Token with no symbol or decimals set may return null for those fields

## How this service works

Total supply of an ERC20 or ERC721 token via totalSupply (eth_call), formatted with decimals and symbol. Example: {token:"0x8335…2913", chain:"base"} → {total_supply, symbol, decimals}. $0.001.

## Output

Returns a JSON object with the token's total supply as a human-readable formatted string (accounting for decimals), the raw integer supply, the token symbol, the number of decimals, the chain name, chain ID, and the source method (eth_call totalSupply).

## 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": [
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "EVM chain (default base)"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Token contract"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "symbol": {
       "type": "string"
      },
      "decimals": {
       "type": [
        "number",
        "null"
       ]
      },
      "total_supply": {
       "type": "string"
      },
      "total_supply_raw": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "source": "eth_call totalSupply",
  "symbol": "USDC",
  "chain_id": 8453,
  "decimals": 6,
  "total_supply": "4324085953.222857",
  "total_supply_raw": "4324085953222857"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc20-erc721-total-supply-lookup-76112fc6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
