# ENS Name & Address Resolver (Ethereum)

> ENS Name & Address Resolver (Ethereum) is a paid API for AI agents from onchaincheck.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Resolves an ENS name (e.g. vitalik.eth) to its Ethereum address and profile records, or reverse-resolves an Ethereum address to its primary ENS name and profile.

## Facts

- Endpoint: GET https://onchaincheck.dev/eth/ens?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ens-name-address-resolver-ethereum-a78f3095
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K_AMmJxWmSw0Le9DYCcaO

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 ens-name-address-resolver-ethereum-a78f3095
```

Example prompt: What Ethereum address and social profile records does vitalik.eth resolve to? I need the avatar, Twitter, GitHub, and any description stored in the ENS records.

## When to prefer this

Use this endpoint when you need a direct, paid, on-demand ENS resolution without running your own Ethereum node or managing RPC providers. It handles both forward (name→address) and reverse (address→name) lookups in a single call and also returns rich profile metadata (avatar, social handles, URL) that standard RPC calls require additional steps to retrieve. Prefer it over generic RPC endpoints when you want profile records alongside address resolution in one request.

## Known failure modes

- ENS name not registered — returns registered: false with no address or records
- Malformed ENS name or address format — schema validation rejects the request
- Name registered but no records set — records object present but fields are empty or null
- Network or resolver timeout when querying the Ethereum mainnet
- Payment failure via x402 protocol resulting in 402 response before data is returned

## How this service works

ENS on Ethereum: resolve a name (vitalik.eth) to its address and profile records (avatar, description, url, Twitter, GitHub), or pass an address instead to get its primary ENS name. Uses ENS's universal resolver.

## Output

Returns a JSON object containing the resolved ENS name, the associated Ethereum address, a set of profile records (avatar URL, description, website URL, Twitter handle, GitHub username), and a boolean indicating whether the name is registered. For reverse lookups by address, returns the primary ENS name and accompanying profile records.

## 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": [],
     "properties": {
      "name": {
       "type": "string",
       "pattern": "^[^\\s]+\\.[^\\s]+$",
       "description": "ENS name, e.g. vitalik.eth"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Address for a reverse lookup instead of name"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "vitalik.eth",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "records": {
   "url": "https://vitalik.ca",
   "avatar": "https://euc.li/vitalik.eth",
   "com.github": "vbuterin",
   "com.twitter": "VitalikButerin",
   "description": "mi pinxe lo crino tcati"
  },
  "registered": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ens-name-address-resolver-ethereum-a78f3095/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onchaincheck.dev](https://www.zero.xyz/host/onchaincheck.dev/llms.txt)