# agentsvc.io ERC20 Token Info Lookup

> agentsvc.io ERC20 Token Info Lookup is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.0045/call, status unknown (last checked 2026-10-10).

Fetches on-chain metadata and optional holder balance for any ERC20 token on Base or Ethereum by contract address.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/erc20-info?utm_source=zero.xyz
- Price: $0.0045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentsvc-io-erc20-token-info-lookup-83c7c8c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_57oGmfoIDUHfm5KrlZJBE

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 agentsvc-io-erc20-token-info-lookup-83c7c8c7 -d '<json body>'
```

Example prompt: What's the name, symbol, total supply, and decimals for the ERC20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, and what's the balance for wallet 0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27?

## When to prefer this

Use this endpoint when you need structured on-chain metadata about any ERC20 token — name, symbol, decimals, total supply — on Base or Ethereum, especially when you also want a specific wallet's token balance in the same call. Prefer this over block explorer scraping when you need machine-readable JSON without parsing HTML, and when you want pay-per-call pricing with no API key setup.

## Known failure modes

- Invalid contract address format (must be 0x-prefixed 40-char hex) returns a validation error
- Contract address exists but is not an ERC20 token may return incomplete or empty metadata
- Unsupported chain value (not 'base' or 'ethereum') returns a schema validation error
- Network RPC errors or chain congestion may cause timeouts
- Holder address provided but holds zero tokens returns balance of 0 rather than an error

## How this service works

86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.

## Output

Returns a JSON object containing the token's name, symbol, decimals, chain, chain ID, total supply (human-readable and raw), a block explorer URL, and optionally the specified holder's balance (human-readable and raw) along with a timestamp of when the data was checked.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "iota-evm"
   ],
   "type": "string",
   "default": "base"
  },
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "ERC20 contract address"
  },
  "holder": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Optional address whose token balance to return"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "name": "USD Coin",
   "chain": "base",
   "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "holder": {
    "address": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27",
    "balance": "0.009",
    "balance_raw": "9000"
   },
   "symbol": "USDC",
   "chain_id": 8453,
   "decimals": 6,
   "explorer": "https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "checked_at": "2026-10-06T12:00:00.000Z",
   "total_supply": "4422012871.202378",
   "total_supply_raw": "4422012871202378"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentsvc-io-erc20-token-info-lookup-83c7c8c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)