# ERC-20 Token Info API (Base/Ethereum)

> ERC-20 Token Info API (Base/Ethereum) is a paid API for AI agents from build-4c941cab041172e9439ece2f.emblem.build, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns on-chain metadata and USD price for any ERC-20 token on Base or Ethereum, including name, symbol, decimals, and total supply.

## Facts

- Endpoint: POST https://build-4c941cab041172e9439ece2f.emblem.build/pub/tasks/x402-onchain/api/token
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-info-api-base-ethereum-a31fa9af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qm7LnmdtJXdCCNms1cQO-

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-info-api-base-ethereum-a31fa9af -d '<json body>'
```

Example prompt: Can you pull up the full token report for the ERC-20 contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need the name, symbol, decimals, total supply, and current USD price.

## When to prefer this

Choose this endpoint when you need a single, comprehensive ERC-20 token metadata report (name, symbol, decimals, supply, and USD price) for a known contract address on Base or Ethereum, without needing to query multiple separate APIs. It is particularly well-suited for DeFi agents, portfolio trackers, and token verification flows that require structured on-chain data with minimal setup and pay-per-call USDC pricing.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty metadata
- Contract exists but has no price feed — USD price field may be null or zero
- Wrong network specified (Base vs Ethereum) causes mismatched or failed lookup
- Payment failure via x402/USDC results in 402 Payment Required response
- Rate limiting or RPC node issues may cause intermittent failures

## How this service works

ERC-20 token report on Base/Ethereum: name, symbol, decimals, total supply, USD price. Onchain pay-per-call in USDC.

## Output

Returns a structured report for the given ERC-20 token contract including: human-readable name, ticker symbol, decimal precision, total supply (in token units), and current USD price sourced from on-chain/oracle data. Useful for token identification, valuation, and metadata enrichment.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-info-api-base-ethereum-a31fa9af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from build-4c941cab041172e9439ece2f.emblem.build](https://www.zero.xyz/host/build-4c941cab041172e9439ece2f.emblem.build/llms.txt)