# ERC-20 Token Metadata Lookup

> ERC-20 Token Metadata Lookup is a paid API for AI agents from store.agentexchange.work, paid per call via x402, $0.09/call, status unknown (last checked 2026-09-14).

Returns on-chain metadata for an ERC-20 token contract — name, symbol, decimals, total supply, and verification flags — across major EVM chains.

## Facts

- Endpoint: GET https://store.agentexchange.work/chain/token
- Price: $0.09/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-2f58d84a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2QC-hN-krOmQRdvCdFZ4F

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-2f58d84a
```

Example prompt: Look up the token metadata for the contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Base — I need the name, symbol, decimals, and total supply.

## When to prefer this

Choose this endpoint when you need lightweight, fast ERC-20 token identity data (name, symbol, decimals, supply) from on-chain state without running a full node or integrating a heavyweight data provider. It's ideal for agents that need to resolve an unfamiliar contract address, validate token metadata before a transaction, or decode raw token amounts. Pay-per-call USDC pricing suits low-volume or sporadic lookups; the $29/month all-access key is better for high-frequency use. Prefer this over general blockchain explorers when you want a clean structured JSON response with no scraping or HTML parsing.

## Known failure modes

- Address is not a deployed contract — is_contract returns false, is_erc20 returns false
- Contract exists but does not implement ERC-20 interface — is_erc20 returns false with warnings
- Invalid address format — likely a 4xx error or empty response
- Unsupported chain identifier — request fails or defaults to Base
- Payment not included or insufficient — 402 Payment Required response

## How this service works

Machine-payable data APIs for AI agents across web search, on-chain reads, trading data, market judgment, and AI visibility. The canonical x402 catalog currently exposes 85 paid routes. Pay per call in USDC via x402 on Base. No API keys, no signup.

## Output

A JSON object containing the token's name, symbol, decimals, total supply (as a human-readable float), the chain it was queried on, whether the address is a deployed contract, whether it conforms to the ERC-20 standard, a flag indicating if decimals were assumed rather than read, and any warnings (e.g. unusual supply, non-standard decimals).

## 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": {
       "type": "string",
       "description": "base|ethereum|optimism|arbitrum|polygon|gnosis (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",
     "properties": {
      "name": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "decimals": {
       "type": "number"
      },
      "is_erc20": {
       "type": "boolean"
      },
      "total_supply": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "chain": "base",
  "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "symbol": "USDC",
  "decimals": 6,
  "is_erc20": true,
  "warnings": [],
  "is_contract": true,
  "total_supply": 4172781685.50414,
  "decimals_assumed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-metadata-lookup-2f58d84a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from store.agentexchange.work](https://www.zero.xyz/host/store.agentexchange.work/llms.txt)