# Tanod chainpeek – ERC-20 Total Supply

> Tanod chainpeek – ERC-20 Total Supply is a paid API for AI agents from tanod.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Returns the total supply, decimals, and symbol of an ERC-20 token on Ethereum, Base, or Robinhood Chain.

## Facts

- Endpoint: POST https://tanod.dev/v1/chain/total-supply?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-chainpeek-erc-20-total-supply-a8daddb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dXkN58EU9EJljNMX1xSTq

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 tanod-chainpeek-erc-20-total-supply-a8daddb5 -d '<json body>'
```

Example prompt: What's the total supply, decimals, and symbol of the USDC token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?

## When to prefer this

Choose this endpoint when you need on-chain ERC-20 token metadata (total supply, decimals, symbol) for Ethereum, Base, or Robinhood Chain without setting up your own RPC infrastructure. It is ideal for agents doing token analysis, DeFi dashboards, or auditing token contracts, especially when Robinhood Chain support is needed.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error
- Unsupported chain value causes a validation error
- Contract address does not exist on the specified chain
- Network timeout or RPC node unavailability
- Malformed address (not matching 0x + 40 hex pattern) rejected at input validation

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

Returns the total supply (as a raw and/or human-readable number), the number of decimals, and the symbol of the specified ERC-20 token on the requested chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "robinhood"
   ],
   "type": "string",
   "description": "ethereum, base or robinhood (Robinhood Chain, chain id 4663)."
  },
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "ERC-20 token contract address (0x + 40 hex)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "symbol and decimals come from the token contract, which can report anything: check the address",
  "block": 52396571,
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "decimals": 6,
  "total_supply": "4399817144.81441",
  "total_supply_raw": "4399817144814410",
  "untrusted_content": true
 }
}
```

## More

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