# Base ERC-20 Token Metadata Lookup

> Base ERC-20 Token Metadata Lookup is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Returns the name, symbol, decimals, and total supply of any ERC-20 token contract on Base mainnet via a read-only eth_call.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/base-erc20-meta?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-erc-20-token-metadata-lookup-4627b363
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__C3pjcVlEIMZPqEMX3ftZ

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 base-erc-20-token-metadata-lookup-4627b363 -d '<json body>'
```

Example prompt: What are the name, symbol, decimals, and total supply of the ERC-20 token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base mainnet?

## When to prefer this

Use this endpoint when you need fast, cheap, read-only ERC-20 metadata (name, symbol, decimals, totalSupply) for a single token on Base mainnet and don't want to run your own RPC node. Ideal for agents enriching token data, validating contracts, or labeling wallet balances. Not suitable for tokens on other EVM chains, batch lookups of many tokens, or writing/transacting on-chain.

## Known failure modes

- Address is not a deployed contract on Base — returns an error
- Contract exists but does not implement ERC-20 interface methods — returns an error
- Malformed or invalid Ethereum address format — request rejected
- Token on a different chain (not Base eip155:8453) — returns incorrect or no data
- Payment not sent — requires exact $0.003 USDC on Base before production endpoint responds

## How this service works

Call when an agent needs ERC-20 name, symbol, decimals, and totalSupply for one Base token. Send token (example Circle USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Read-only eth_call on eip155:8453. Not a contract, or no ERC-20 methods, errors. No spend. Send JSON {"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/base-erc20-meta first.

## Output

Returns a JSON object with the token's name (string), symbol (string), decimals (integer), and totalSupply (large integer or string), read directly from the ERC-20 contract on Base mainnet. Errors if the address is not a contract or does not implement ERC-20 methods.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "examples": [
    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
   ],
   "description": "ERC-20 contract on Base mainnet (eip155:8453). Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (Circle USDC). EIP-55 or all one case. Returns name, symbol, decimals, and total supply. Read-only."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-erc-20-token-metadata-lookup-4627b363/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)