# 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 image URL associated with an ENS name or Ethereum address

## Facts

- Endpoint: GET https://api.web3identity.com/api/ens/avatar/opensea.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-240ac863
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X2nMKxX8t7Ph0f4qw2_7T

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-240ac863
```

Example prompt: What's the avatar image URL for opensea.eth? I want to display their ENS profile picture in my app.

## When to prefer this

Use this endpoint when you need to display or retrieve the avatar/profile image for a known ENS name or Ethereum address, particularly for building web3 profile UIs, social features, or identity displays. Prefer this over full ENS resolution when you only need the avatar URL without the full record set.

## Known failure modes

- ENS name not found or not registered — returns 404 or null
- No avatar set for the ENS name — returns empty or null URL
- Invalid ENS name format — returns 400 bad request
- Ethereum address not linked to any ENS name with avatar — returns null
- Network timeout resolving ENS records — returns 503

## How this service works

Get avatar URL for ENS name or address

## Output

Returns the URL of the avatar image associated with the given ENS name or Ethereum address, typically pointing to an IPFS-hosted image, NFT metadata image, or HTTP URL set in the ENS text records.

## Example request

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-web3identity-com-240ac863/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)