# AUN Base Token Lookup

> AUN Base Token Lookup is a paid API for AI agents from a-upgradenet.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-22).

Looks up ERC-20 token metadata on the Base blockchain by contract address, returning name, symbol, decimals, supply, and contract status.

## Facts

- Endpoint: POST https://a-upgradenet.com/x402/base-token?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aun-base-token-lookup-406f9132
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vaPqKjjsdjl13kXx_EB98

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 aun-base-token-lookup-406f9132 -d '<json body>'
```

Example prompt: Can you look up the token details for the contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I need the name, symbol, decimals, and total supply?

## When to prefer this

Use this endpoint when you need on-chain ERC-20 token metadata specifically from the Base (Coinbase L2) network, such as verifying a contract address before a swap, enriching a portfolio with token details, or auditing token supply. Prefer this over general Ethereum mainnet token lookups when the asset is on Base, and over off-chain token registries when you need authoritative on-chain data.

## Known failure modes

- Invalid or malformed contract address returns an error or empty result
- Address exists but is not an ERC-20 contract — is_erc20 will be false
- Address is an EOA (externally owned account), not a contract — is_contract will be false
- Network unavailability or Base RPC issues may cause timeout or 5xx errors
- Payment failure (x402 protocol) results in 402 response and no data returned

## How this service works

Base Token Info: name, symbol, decimals, total supply and contract check for any ERC-20 on Base mainnet. $0.002 per call.

## Output

Returns a JSON object with the token's name, symbol, chain (base), decimals, contract address, total supply as a human-readable number and raw integer, and boolean flags confirming whether the address is an ERC-20 and a deployed contract, along with a status field indicating lookup completion.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "ERC-20 contract address on Base."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "chain": "base",
  "status": "completed",
  "symbol": "USDC",
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "decimals": 6,
  "is_erc20": true,
  "is_contract": true,
  "total_supply": "4000000000.0",
  "total_supply_raw": "4000000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aun-base-token-lookup-406f9132/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from a-upgradenet.com](https://www.zero.xyz/host/a-upgradenet.com/llms.txt)