# ChainRead ERC-20 Metadata Lookup

> ChainRead ERC-20 Metadata Lookup is a paid API for AI agents from chainread.imac2014ville.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Fetches ERC-20 token metadata (name, symbol, decimals, total supply, proxy info) for a given contract address on Base or Ethereum mainnet

## Facts

- Endpoint: GET https://chainread.imac2014ville.workers.dev/erc20?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainread-erc-20-metadata-lookup-51e88a9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d5pi0vXmYeXSeE3ItbUug

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 chainread-erc-20-metadata-lookup-51e88a9e
```

Example prompt: What's the name, symbol, decimals, and total supply for the ERC-20 contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — and is it a proxy contract?

## When to prefer this

Use this endpoint when you need lightweight, low-cost ERC-20 token metadata (name, symbol, decimals, total supply, proxy info) on Base or Ethereum mainnet without managing your own RPC node or API keys. It is ideal for AI agents that need to enrich token data on-the-fly, paying micro-amounts per call via USDC on Base (x402). Prefer this over full node queries or heavier blockchain indexers when you only need standard ERC-20 contract metadata and want minimal setup.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or unexpected data
- Unsupported chain value (only 'base' and 'ethereum' are valid) results in an error
- Contract address not found on the specified chain
- Network/RPC timeouts causing delayed or failed responses
- Missing required 'token' query parameter returns a validation error

## How this service works

Cheap EVM read utilities for AI agents on Base and Ethereum mainnet: gas and fees, blocks, balances, ERC-20 metadata, contract inspection, transaction status, ENS/Basename resolution, bulk balances. No API key: pay USDC on Base per call via x402.

## Output

Returns a JSON object with ok status, token name, symbol, decimals, total supply (as a string), chain, token address, whether it is a proxy contract, proxy kind (e.g. EIP-1967), and the implementation contract address if applicable.

## 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"
       ],
       "type": "string",
       "description": "Chain to read (default base)"
      },
      "token": {
       "type": "string",
       "description": "ERC-20 contract address (0x…)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "name": "USD Coin",
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "isProxy": true,
  "decimals": 6,
  "proxyKind": "EIP-1967",
  "totalSupply": "4100000000",
  "implementation": "0x2ce6311ddae708829bc0784c967b7d77d19fd779"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainread-erc-20-metadata-lookup-51e88a9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainread.imac2014ville.workers.dev](https://www.zero.xyz/host/chainread.imac2014ville.workers.dev/llms.txt)