# ERC-20 Token Lookup by Contract Address

> ERC-20 Token Lookup by Contract Address is a paid API for AI agents from dt0ur.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-30).

Looks up ERC-20 token metadata and live market data (name, symbol, decimals, total supply, USD price, FDV, proxy status) by contract address across 6 EVM chains

## Facts

- Endpoint: POST https://dt0ur.online/api/onchain/token?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-lookup-by-contract-address-16cc8388
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_77D3EgnP_AI8cW5Ym5a9C

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 erc-20-token-lookup-by-contract-address-16cc8388 -d '<json body>'
```

Example prompt: Can you look up the ERC-20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need its name, symbol, decimals, current USD price, and whether it's an upgradeable proxy?

## When to prefer this

Use this endpoint when you need on-chain ERC-20 token metadata combined with live market pricing in a single call across Base, Ethereum, Arbitrum, Optimism, Polygon, or BSC. Prefer it over generic blockchain explorers when you also need proxy detection (EIP-1967/EIP-1167) and implementation address resolution in one response. It complements the sibling wallet balance endpoint when you need token-level details rather than wallet-level holdings.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Unsupported chain value outside the allowed enum causes a validation error
- Contract address exists but is not an ERC-20 token may return partial or null metadata
- Price data may be unavailable for very obscure or newly deployed tokens
- Network congestion or RPC issues on the target chain may cause timeouts

## How this service works

ERC-20 token lookup by contract address on base, ethereum, arbitrum, optimism, polygon, bsc: name, symbol, decimals, total supply, live USD price, fully diluted value, and whether the token is an upgradeable proxy (EIP-1967/EIP-1167, with implementation address).

## Output

Returns structured token metadata including: token name, symbol, number of decimals, total supply, live USD price, fully diluted valuation (FDV), a boolean indicating whether the contract is an upgradeable proxy (EIP-1967/EIP-1167), and the implementation contract address if applicable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc"
   ],
   "type": "string",
   "default": "base",
   "description": "EVM chain: base, ethereum, arbitrum, optimism, polygon, bsc (default base)"
  },
  "token": {
   "type": "string",
   "description": "Token contract address (0x...)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-lookup-by-contract-address-16cc8388/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from dt0ur.online](https://www.zero.xyz/host/dt0ur.online/llms.txt)