# Xerxes ERC20 Total Supply

> Xerxes ERC20 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-02).

Returns the total supply of a given ERC-20 token contract on Ethereum mainnet as a decimal string.

## Facts

- Endpoint: GET https://ari001.tailb4ac3a.ts.net/v1/ventures/ethereum_rpc_api/erc20_total_supply?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xerxes-erc20-total-supply-0195c185
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9bCHvCaURi4EakQvz1yA-

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 xerxes-erc20-total-supply-0195c185
```

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

## When to prefer this

Use this endpoint when you need the on-chain totalSupply() value for a specific ERC-20 contract on Ethereum mainnet. It is ideal for agents that need token supply data for DeFi analysis, tokenomics research, or due diligence without setting up their own Ethereum node or RPC provider. Prefer this over generic blockchain explorers when you want a machine-readable decimal string response suitable for downstream computation.

## Known failure modes

- Invalid contract address format (not matching 0x + 40 hex) — validation error returned
- Contract address is not an ERC-20 contract — may return zero or error
- Ethereum mainnet RPC unavailable — service-level error returned with ok: false
- Address is a valid hex but non-existent or non-contract account — returns zero or error
- Network congestion or timeout from the underlying RPC node

## How this service works

Returns the total supply of an ERC20 token contract on Ethereum mainnet, as a decimal string. Query: token (ERC-20 contract, 0x + 40 hex).

## Output

Returns a JSON object with an 'ok' boolean, a 'result' field containing the uint256 total supply as a decimal string, the chain name, the method called, and the service name. On failure, includes an 'error' field describing what went wrong.

## 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",
     "required": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{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/xerxes-erc20-total-supply-0195c185/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)