# ETH ENS Resolve

> ETH ENS Resolve is a paid API for AI agents from api.arysphere.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-22).

Resolves an ENS .eth name to its Ethereum address (forward lookup), or resolves an Ethereum address to its verified primary ENS name (reverse lookup).

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/eth_ens_resolve?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eth-ens-resolve-a2d5751d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vGzGOUF8_BySjdf8JU8XW

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 eth-ens-resolve-a2d5751d
```

Example prompt: What Ethereum address does vitalik.eth resolve to? And can you also do the reverse — what's the primary ENS name for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?

## When to prefer this

Use this endpoint when you need to resolve ENS names to Ethereum addresses or perform verified reverse lookups (address to ENS name) on Ethereum mainnet. It handles both directions in a single paid call at $0.003 USDC. Prefer this over manually querying ENS contracts when you need a simple, agent-callable API without managing your own Ethereum node or ENS SDK.

## Known failure modes

- ENS name not registered or has no resolver set — returns null or empty result
- Address has no verified primary ENS name set — reverse lookup returns nothing
- Invalid address format (not 0x + 40 hex) — request rejected
- Name not a valid .eth ASCII domain — request rejected
- Ethereum mainnet node unavailable — service error
- Neither name nor address provided — missing required query param error

## How this service works

ENS resolver on Ethereum mainnet: pass name (an ASCII .eth name, e.g. vitalik.eth) to get its address, or pass address (0x + 40 hex) to get its verified primary ENS name. One paid call, USDC on Base.

## Output

Returns either the resolved Ethereum address (0x hex) for a given .eth ENS name, or the verified primary ENS name string for a given Ethereum address. The result confirms the bidirectional mapping as registered on Ethereum mainnet.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string",
       "description": "an ASCII .eth name (forward), OR"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "0x + 40 hex (reverse, verified)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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