# ERC-20 Token Info Lookup by Chain

> ERC-20 Token Info Lookup by Chain is a paid API for AI agents from ai-policy-kit.moneymaker-ai.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-19).

Returns detailed metadata and on-chain statistics for an ERC-20 token contract address on a specified blockchain network

## Facts

- Endpoint: GET https://ai-policy-kit.moneymaker-ai.workers.dev/api/token-info?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-info-lookup-by-chain-cbe98564
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7mNGHG3bhQlKfSczHiFbf

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-info-lookup-by-chain-cbe98564
```

Example prompt: Can you look up the on-chain token info for USDC at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want the name, symbol, decimals, total supply, and proxy details?

## When to prefer this

Use this endpoint when you need fast, structured on-chain metadata for a known ERC-20 token contract across major EVM-compatible chains, especially when you need proxy contract details, total supply, or owner information without running your own RPC node. Prefer this over manual RPC calls or block explorers when you need machine-readable JSON output for downstream automation.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty result
- Unsupported chain value returns a validation error
- Malformed 0x address format causes a 400-level error
- Contract with no proxy returns null proxy fields
- RPC node unavailability for the target chain causes a timeout or 500 error

## How this service works

Generate an AI_POLICY.md and a pull request template with an AI-disclosure section for your open-source repo. Free, runs in your browser.

## Output

A JSON object containing the token's name, symbol, decimals, chain ID, current block number, contract address, owner address, raw and formatted total supply, contract bytecode size, and full proxy details (admin address, implementation address, and proxy standard) 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": [
      "chain",
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "bsc",
        "arbitrum",
        "optimism",
        "polygon",
        "gnosis",
        "celo"
       ],
       "type": "string"
      },
      "token": {
       "type": "string",
       "description": "0x token contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "block": 52783453,
  "chain": "base",
  "owner": "0x3ABd6f64A422225E61E435baE41db12096106df7",
  "proxy": {
   "admin": "0x4fc7850364958d97B4d3f5A08f79db2493f8cA44",
   "standard": "OpenZeppelin legacy (zos) slot",
   "implementation": "0x2Ce6311ddAE708829bc0784C967b7d77D19FD779"
  },
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "chainId": 8453,
  "decimals": 6,
  "code_bytes": 1852,
  "total_supply": "4318565539.872118",
  "total_supply_raw": "4318565539872118"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-info-lookup-by-chain-cbe98564/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-policy-kit.moneymaker-ai.workers.dev](https://www.zero.xyz/host/ai-policy-kit.moneymaker-ai.workers.dev/llms.txt)