# Ethereum Token Metadata Lookup

> Ethereum Token Metadata Lookup is a paid API for AI agents from synapse-api-brown.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns metadata (name, symbol, decimals, etc.) for an ERC-20 or other token contract on the Ethereum network given a contract address.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/ethereum/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/ethereum-token-metadata-lookup-ad510f3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H4uJ4MQgZjHowAx8GAmej

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 ethereum-token-metadata-lookup-ad510f3b -d '<json body>'
```

Example prompt: What's the name, symbol, and number of decimals for the Ethereum token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?

## When to prefer this

Use this endpoint when you need to resolve an Ethereum mainnet contract address to its human-readable token metadata (name, symbol, decimals). Prefer this over generic blockchain explorers when you need a pay-per-call, programmatic, agent-friendly API response rather than a web page. Suitable for enriching wallet data, validating tokens before transactions, or building token lists.

## Known failure modes

- Invalid or malformed contract address returns an error response
- Contract address exists but is not a token contract (e.g. a plain wallet or non-ERC-20 contract) may return empty or error
- Network timeout or RPC node issues may cause delayed or failed responses
- Non-Ethereum contract addresses (e.g. from other chains) will not be resolved by this endpoint

## How this service works

High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.

## Output

Returns on-chain token metadata for the given Ethereum contract address, typically including the token name (e.g. 'USD Coin'), ticker symbol (e.g. 'USDC'), decimal precision (e.g. 6), and potentially additional fields like total supply or token standard.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "contractAddress": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ethereum-token-metadata-lookup-ad510f3b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from synapse-api-brown.vercel.app](https://www.zero.xyz/host/synapse-api-brown.vercel.app/llms.txt)