# ERC-20 Token Metadata Lookup

> ERC-20 Token Metadata Lookup is a paid API for AI agents from webtools402.176-109-107-191.sslip.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Fetches live on-chain metadata (name, symbol, decimals, totalSupply) for an ERC-20 token contract on Base, Ethereum, Arbitrum, Optimism, Polygon, or BNB Chain.

## Facts

- Endpoint: GET https://webtools402.176-109-107-191.sslip.io/token/meta
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-metadata-lookup-1502df64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CObUZuJFwMjmwRX3IvK65

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-metadata-lookup-1502df64
```

Example prompt: Can you pull the on-chain metadata — name, symbol, decimals, and total supply — for the ERC-20 token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on the Base network?

## When to prefer this

Use this endpoint when you need live, on-chain ERC-20 token metadata (name, symbol, decimals, totalSupply) directly from contract state across major EVM networks. Prefer this over cached or aggregator sources when accuracy and freshness matter, or when the token is not listed on major indexes.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty metadata
- Unsupported network enum value returns a validation error
- Contract not deployed on the specified network returns a contract-not-found error
- Malformed address format (not 0x-prefixed hex) returns a bad request error
- RPC node unavailability may cause transient failures

## How this service works

ERC-20 token metadata on Base, Ethereum, Arbitrum, Optimism, Polygon or BNB (default Base): name, symbol, decimals and totalSupply (raw + human), read live from contract state by address.

## Output

Returns the token's name, symbol, decimal count, and total supply in both raw (integer) and human-readable (decimal-adjusted) form, read live from the contract on the specified EVM network.

## 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",
       "description": "ERC-20 contract address (0x..)"
      },
      "network": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon",
        "bnb"
       ],
       "type": "string",
       "description": "EVM network to read from (default base)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-metadata-lookup-1502df64/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from webtools402.176-109-107-191.sslip.io](https://www.zero.xyz/host/webtools402.176-109-107-191.sslip.io/llms.txt)