# ETH Mainnet ERC-20 Total Supply

> ETH Mainnet ERC-20 Total Supply is a paid API for AI agents from ari001.tailb4ac3a.ts.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-27).

Returns the total supply of an ERC-20 token contract on Ethereum Mainnet by calling totalSupply on the given token address.

## Facts

- Endpoint: GET https://ari001.tailb4ac3a.ts.net/v1/ventures/x402_eth_reads_v1/eth_mainnet_erc20_totalsupply?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eth-mainnet-erc-20-total-supply-d9b9ba4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TxLNe4g1vdtu-wdlL_5Yg

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 eth-mainnet-erc-20-total-supply-d9b9ba4c
```

Example prompt: What's the total supply of the ERC-20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet?

## When to prefer this

Use this endpoint when you need the on-chain total supply of an ERC-20 token on Ethereum Mainnet specifically. Prefer this over alternative endpoints when you want a direct, low-latency blockchain read without additional AI interpretation or bundled data. This is ideal for agents performing tokenomics analysis, monitoring supply changes, or verifying contract details on Ethereum mainnet (not Base or Gnosis — use sibling endpoints for those chains).

## Known failure modes

- Invalid token address format (must be 0x + 40 hex characters) returns a validation error
- Contract address is not an ERC-20 token (lacks totalSupply function) results in a contract call failure
- Network connectivity issues to Ethereum mainnet RPC may cause timeouts
- Non-existent or zero-address contracts may return zero or an error
- Payment failure ($0.003 USDC) prevents the request from being processed

## How this service works

Total supply of an ERC-20 token contract on Ethereum via totalSupply given token address. Base ERC-20 read of token contract address.

## Output

Returns the total supply value from the ERC-20 contract's totalSupply() function on Ethereum Mainnet, representing the total number of tokens that have been minted (minus burned), typically as a large integer in the token's base units.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC-20 contract, 0x + 40 hex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "service"
     ],
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "chain": {
       "type": "string"
      },
      "error": {
       "type": "string",
       "description": "present when ok is false"
      },
      "method": {
       "type": "string"
      },
      "result": {
       "type": "string",
       "description": "the uint256 as a decimal string"
      },
      "service": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eth-mainnet-erc-20-total-supply-d9b9ba4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ari001.tailb4ac3a.ts.net](https://www.zero.xyz/host/ari001.tailb4ac3a.ts.net/llms.txt)