# Keyronne ERC-20 Token Metadata Lookup

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

Fetches ERC-20 token metadata (name, symbol, decimals, total supply) and optionally a wallet's token balance for any token contract across Ethereum, Base, Arbitrum, Optimism, Polygon, or BNB Chain

## Facts

- Endpoint: POST https://keyronne.com/api/chain-token
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/keyronne-erc-20-token-metadata-lookup-53ff03b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nmw9glBefNrlQqow6JaIy

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 keyronne-erc-20-token-metadata-lookup-53ff03b6 -d '<json body>'
```

Example prompt: What's the name, symbol, decimals, and total supply of the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — and also tell me the balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?

## When to prefer this

Use this endpoint when you need on-chain ERC-20 token metadata (name, symbol, decimals, total supply) or a wallet's token balance across the six supported chains (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain) without needing your own RPC keys or infrastructure. Prefer this over raw RPC calls when you want a simple JSON response without managing ABI encoding.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty metadata
- Unsupported chain value returns a validation error
- Malformed Ethereum address (wrong length/checksum) causes a parsing error
- Token contract exists but does not implement standard ERC-20 methods (e.g. name/symbol) may return partial data or error
- Network RPC node temporarily unavailable causes a timeout or upstream error

## How this service works

ERC-20 token metadata — name, symbol, decimals, total supply — for any token contract on Ethereum, Base, Arbitrum, Optimism, Polygon, or BNB Chain. Optionally include a "holder" address to also read that wallet's balance. Public JSON-RPC reads, no API keys. POST a JSON body like: {"chain":"base","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}

## Output

Returns a JSON object with the token's name, symbol, decimals, and total supply. If a holder address was provided, also includes that wallet's balance of the token, all read directly from public JSON-RPC nodes with no API key required.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc"
   ],
   "type": "string"
  },
  "holder": {
   "type": "string",
   "description": "Optional wallet whose balance to include."
  },
  "address": {
   "type": "string",
   "description": "Token contract address."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/keyronne-erc-20-token-metadata-lookup-53ff03b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from keyronne.com](https://www.zero.xyz/host/keyronne.com/llms.txt)