# Fathom API - ERC-20 Token Metadata Lookup

> Fathom API - ERC-20 Token Metadata Lookup is a paid API for AI agents from fathom-api.mioku-fathom.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns ERC-20 token metadata (address, symbol, name, decimals) for a given Base network token contract address.

## Facts

- Endpoint: GET https://fathom-api.mioku-fathom.workers.dev/v1/metadata
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-api-erc-20-token-metadata-lookup-c1b72c96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e-MyQLWi85xLPiIOFhzZB

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 fathom-api-erc-20-token-metadata-lookup-c1b72c96
```

Example prompt: What are the name, symbol, and decimals for the Base ERC-20 token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?

## When to prefer this

Use this endpoint when you need basic ERC-20 token metadata (name, symbol, decimals) for a known contract address on the Base network. Ideal for enriching token display information, validating token identity, or preparing data for DeFi operations. Prefer this over the sibling price endpoint when you only need token descriptive metadata rather than pricing or liquidity data.

## Known failure modes

- Invalid or malformed token address (not matching 0x + 40 hex chars) returns a validation error
- Token address not found on Base network returns an empty or error response
- Payment of 0.001 USDC not provided results in HTTP 402 Payment Required
- Network or Cloudflare Worker downtime causes service unavailability

## How this service works

Returns ERC-20 metadata for a Base token, including address, symbol, name, and decimals.

## Output

Returns a JSON object containing the token's contract address, human-readable name (e.g. 'USD Coin'), ticker symbol (e.g. 'USDC'), and decimal precision (e.g. 6) for the specified Base ERC-20 token.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "const": "base",
       "default": "base"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "Base ERC-20 token address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "symbol",
      "name",
      "decimals"
     ],
     "properties": {
      "name": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "address": {
       "type": "string"
      },
      "decimals": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-api-erc-20-token-metadata-lookup-c1b72c96/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fathom-api.mioku-fathom.workers.dev](https://www.zero.xyz/host/fathom-api.mioku-fathom.workers.dev/llms.txt)