# Multichain RPC – ERC-20 Token Metadata Lookup

> Multichain RPC – ERC-20 Token Metadata Lookup is a paid API for AI agents from multichain-rpc.clankerceo.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns ERC-20 token metadata (name, symbol, decimals, total supply) for a given contract address on Base, Polygon, Arbitrum, Optimism, or Ethereum.

## Facts

- Endpoint: GET https://multichain-rpc.clankerceo.workers.dev/erc20-token
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/multichain-rpc-erc-20-token-metadata-lookup-0e0cade7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1wEMm_Hr994Kox97k2ezQ

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 multichain-rpc-erc-20-token-metadata-lookup-0e0cade7
```

Example prompt: What's the name, symbol, decimals, and total supply for the ERC-20 contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?

## When to prefer this

Choose this endpoint when you need lightweight, per-call ERC-20 token metadata across multiple EVM chains without running your own RPC node. It is ideal for agents that need to resolve token decimals, names, or supply figures on Base, Polygon, Arbitrum, Optimism, or Ethereum cheaply ($0.002/call) and without managing API keys for individual chain providers.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty response
- Unsupported chain name returns an error
- Contract address with no deployed code returns an error
- Network congestion on the target chain may cause timeouts
- Malformed query parameters (missing chain or contract) return a 400-level error

## How this service works

Cheap, factual EVM chain lookups priced per call in USDC. Base, Polygon, Arbitrum, Optimism and Ethereum.

## Output

A JSON object containing the token's name, symbol, chain, contract address, decimals (integer), and total supply expressed both as a raw integer string and a human-readable decimal amount.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "enum": [
      "http"
     ],
     "type": "string"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string"
      },
      "contract": {
       "type": "string"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "enum": [
      "json"
     ],
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "chain": "base",
  "symbol": "USDC",
  "contract": "0x…",
  "decimals": 6,
  "totalSupply": {
   "raw": "1",
   "amount": "0.000001"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/multichain-rpc-erc-20-token-metadata-lookup-0e0cade7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from multichain-rpc.clankerceo.workers.dev](https://www.zero.xyz/host/multichain-rpc.clankerceo.workers.dev/llms.txt)