# ERC-20 Token Total Supply

> ERC-20 Token Total Supply is a paid API for AI agents from www.x402financialdata.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the raw total supply for a given ERC-20 token contract address on Ethereum mainnet, sourced from Etherscan V2.

## Facts

- Endpoint: GET https://www.x402financialdata.com/token-supply/:contract_address
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-total-supply-d4f3f7e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rzwLvSPW83a0doAgViGwX

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 erc-20-token-total-supply-d4f3f7e1
```

Example prompt: What is the total supply of USDC? The contract address on Ethereum is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.

## When to prefer this

Use this endpoint when you need the raw on-chain total supply of an ERC-20 token on Ethereum mainnet and nothing more. It is ideal for supply audits, inflation tracking, or enriching token metadata pipelines. Do not use it for price or market cap data (use /crypto-prices instead), for tokens on chains other than Ethereum, or for non-ERC-20 contracts.

## Known failure modes

- Invalid or non-existent contract address returns an error or zero value
- Contract address is not an ERC-20 token (e.g. ERC-721 NFT) and may return unexpected data
- Only Ethereum mainnet ('eth') is supported; requests for other chains will fail
- Rate limiting or Etherscan API downtime may cause transient failures
- Malformed contract address format returns a validation error

## How this service works

Total supply for an ERC-20 token contract, from Etherscan's V2 API. Raw value only, no market data -- for price/market cap use /crypto-prices instead. $0.005/call.

## Output

A raw integer value representing the total supply of the specified ERC-20 token as recorded on the Ethereum blockchain via Etherscan V2. No price, market cap, or decimals-adjusted value is included.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "contract_address"
     ],
     "properties": {
      "contract_address": {
       "type": "string",
       "description": "ERC-20 token contract address"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "chain": {
       "enum": [
        "eth"
       ],
       "type": "string",
       "description": "Which chain to query. Only 'eth' is supported right now."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-total-supply-d4f3f7e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.x402financialdata.com](https://www.zero.xyz/host/www.x402financialdata.com/llms.txt)