# Lumen EVM Address Lookup

> Lumen EVM Address Lookup is a paid API for AI agents from lumenworks-x402-decoder.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Look up an EVM address or ENS name on Ethereum and Base: resolves ENS forward/reverse/text records, detects EOA vs contract (EIP-7702), returns native ETH balance, tx count, USDC/USDT balances

## Facts

- Endpoint: POST https://lumenworks-x402-decoder.onrender.com/v1/evm/address?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumen-evm-address-lookup-f4bae9ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S2IPIrI_X_kIJRtL6G-ZM

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 lumen-evm-address-lookup-f4bae9ae -d '<json body>'
```

Example prompt: Can you look up vitalik.eth and tell me its ETH and USDC balances on both Ethereum and Base, whether it's a contract or regular wallet, and any ENS profile info like Twitter handle or website?

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-chain snapshot of any EVM address or ENS name in a single call — combining identity (ENS resolution + text records), asset balances (ETH + USDC/USDT), and account type classification (EOA vs contract, EIP-7702) across both Ethereum mainnet and Base. Prefer it over block explorer APIs when you need structured JSON output ready for agent consumption without manual scraping.

## Known failure modes

- Invalid or non-existent ENS name returns null for ENS fields
- Address with no on-chain activity returns zero balances and tx count
- RPC node unavailability may cause timeout or 503 error
- Malformed address input returns a 400 validation error
- ENS name not registered returns no resolution

## How this service works

Look up an EVM address or ENS name on Ethereum + Base: ENS forward/reverse + text records, EOA vs contract (EIP-7702 delegation flag), native balance, tx count, USDC/USDT balances, and ERC-20 name/sy…

## Output

Returns a JSON object with: resolved address, ENS name, timestamp, data source, and per-chain data for Ethereum and Base including native ETH balance, USDC/USDT stablecoin balances, transaction count, code size, contract flag, EIP-7702 delegation flag, and ENS text records (avatar, URL, Twitter, GitHub, description).

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "at": "2026-10-10T12:48:30.232Z",
  "ens": "vitalik.eth",
  "chains": {
   "base": {
    "txCount": 70,
    "codeSize": 23,
    "isContract": true,
    "stablecoins": {
     "USDC": "44.783666"
    },
    "nativeBalance": "3.12882180347263728",
    "eip7702Delegated": true
   },
   "ethereum": {
    "txCount": 5969,
    "codeSize": 23,
    "isContract": true,
    "stablecoins": {
     "USDC": "37.192124",
     "USDT": "291.368219"
    },
    "nativeBalance": "5.768184715803065014",
    "eip7702Delegated": true
   }
  },
  "source": "public RPC (publicnode.com)",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "ensRecords": {
   "url": "https://vitalik.ca",
   "avatar": "https://euc.li/vitalik.eth",
   "com.github": "vbuterin",
   "com.twitter": "VitalikButerin",
   "description": "mi pinxe lo crino tcati"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumen-evm-address-lookup-f4bae9ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lumenworks-x402-decoder.onrender.com](https://www.zero.xyz/host/lumenworks-x402-decoder.onrender.com/llms.txt)