# ENS Avatar Lookup

> ENS Avatar Lookup is a paid API for AI agents from api.web3identity.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns the avatar URL associated with an ENS name or Ethereum address

## Facts

- Endpoint: GET https://api.web3identity.com/api/ens/avatar/coinbase.eth
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-web3identity-com-ba42c71e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0jElXuohVe-HI8Hf6n0xz

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 api-web3identity-com-ba42c71e
```

Example prompt: What's the avatar image URL for coinbase.eth on ENS?

## When to prefer this

Use this endpoint when you need to display or fetch the avatar/profile image associated with an ENS name or Ethereum wallet address, particularly in Web3 identity, social, or wallet UI contexts. Prefer over generic ENS resolvers when you specifically need only the avatar URL without full record resolution.

## Known failure modes

- ENS name not found or not registered — returns null or 404
- No avatar record set on the ENS name — returns empty or null avatar URL
- Invalid ENS name or malformed Ethereum address — returns 400 or error response
- Rate limit exceeded — returns 429
- ENS resolver unavailable — returns 503

## How this service works

Get avatar URL for ENS name or address

## Output

A URL pointing to the avatar image set for the given ENS name or Ethereum address — typically an IPFS link, HTTP URL, or NFT image reference.

## Example request

```json
{
 "name": "vitalik.eth"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-web3identity-com-ba42c71e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.web3identity.com](https://www.zero.xyz/host/api.web3identity.com/llms.txt)