# x402 Agent Hub – ERC-20 Token Metadata

> x402 Agent Hub – ERC-20 Token Metadata is a paid API for AI agents from x402-agent-hub.x402-agent-hub.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-14).

Returns name, symbol, decimals, and formatted total supply for any ERC-20 token contract across 7 EVM chains in a single GET call.

## Facts

- Endpoint: GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/token-info?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agent-hub-erc-20-token-metadata-9b510ccf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-ECngYca-NB_VUzHVNPLe

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 x402-agent-hub-erc-20-token-metadata-9b510ccf
```

Example prompt: What's the name, symbol, decimals, and total supply for the ERC-20 token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?

## When to prefer this

Choose this endpoint when you need a single, cheap, multi-chain ERC-20 metadata lookup (name, symbol, decimals, total supply) without running your own RPC node or writing on-chain calls. It covers 7 major EVM chains in one unified API and only charges $0.002 USDC on successful reads, making it ideal for agents enriching token data, auditing unknown contracts, or populating UI metadata before a trade or transfer.

## Known failure modes

- Invalid or non-checksummed token address returns an error and cancels payment settlement
- Token address not found on the specified chain returns a not-found error with no charge
- Unsupported chain name or chain ID returns a validation error
- Upstream RPC or node failure cancels settlement with no charge
- Missing required 'token' query parameter returns a 400-level error

## How this service works

ERC-20 token metadata on 7 EVM chains: name, symbol, decimals and formatted total supply in one call. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.

## Output

A JSON object containing the token's canonical name, ticker symbol, number of decimals, the chain name and numeric chain ID, the contract address queried, and the total supply in both raw (integer) and human-formatted (decimal-adjusted) forms along with the symbol for convenience.

## 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 (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted."
      },
      "token": {
       "type": "string",
       "description": "0x-prefixed ERC-20 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",
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "chainId": 8453,
  "decimals": 6,
  "totalSupply": {
   "raw": "4170000000000000",
   "symbol": "USDC",
   "decimals": 6,
   "formatted": "4170000000"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agent-hub-erc-20-token-metadata-9b510ccf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-hub.x402-agent-hub.workers.dev](https://www.zero.xyz/host/x402-agent-hub.x402-agent-hub.workers.dev/llms.txt)
