# propeller.rocks ERC-20 Token Metadata Lookup

> propeller.rocks ERC-20 Token Metadata Lookup is a paid API for AI agents from propeller.rocks, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches on-chain metadata (name, symbol, decimals, totalSupply) for any ERC-20 token by contract address

## Facts

- Endpoint: GET https://propeller.rocks/token/metadata
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/propeller-rocks-erc-20-token-metadata-lookup-803cfeb3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_40c7Six6r2CRQcd_fu1xT

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 propeller-rocks-erc-20-token-metadata-lookup-803cfeb3
```

Example prompt: What are the name, symbol, decimals, and total supply for the ERC-20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?

## When to prefer this

Use this endpoint when you need authoritative on-chain ERC-20 token metadata directly from the contract rather than from a centralized token list or third-party API. Ideal for verifying token identity, normalizing token amounts using decimals, or resolving unknown contract addresses in DeFi workflows.

## Known failure modes

- Contract address is not a valid ERC-20 token — returns error or missing fields
- Invalid or malformed contract address — returns 400-level error
- Contract deployed on unsupported chain — returns error
- Token contract lacks standard ERC-20 metadata methods — partial or empty response

## How this service works

On-chain ERC-20 token metadata (name, symbol, decimals, totalSupply)

## Output

Returns the on-chain ERC-20 token metadata: human-readable name (e.g. 'USD Coin'), ticker symbol (e.g. 'USDC'), decimals (e.g. 6), and totalSupply as a raw integer from the blockchain contract.

## More

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