# ENS Name Resolution API

> ENS Name Resolution API is a paid API for AI agents from api.api-agent-ia.ch, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-26).

Resolves an ENS (Ethereum Name Service) domain name to its underlying Ethereum wallet address

## Facts

- Endpoint: GET https://api.api-agent-ia.ch/resolution-nom?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ens-name-resolution-api-3fe9df53
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KxQMDTZo29I-tcia7DvMk

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-resolution-api-3fe9df53
```

Example prompt: What Ethereum address does vitalik.eth resolve to?

## When to prefer this

Use this endpoint when you need to resolve a human-readable .eth ENS domain name to its underlying Ethereum address, especially within an agent workflow that handles blockchain transactions, identity verification, or address enrichment. It is particularly useful when working alongside other blockchain tools on the same platform (e.g. transaction count, token supply) from api.api-agent-ia.ch.

## Known failure modes

- ENS name not found or not registered — may return an error or null address
- ENS name expired — returns no address or stale address
- Invalid ENS name format — input validation error
- Network timeout reaching ENS resolver
- ENS name exists but has no address record set

## How this service works

Which address is behind this ENS name? Resolves a .eth name on Ethereum mainnet to its 0x address; unknown names return 404 and are not charged ($0.002 per call).

## Output

A JSON object containing the queried ENS name, the network (e.g. 'ethereum'), and the resolved Ethereum wallet address (e.g. '0x...'). Returns the canonical address the ENS name currently points to on the Ethereum network.

## 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",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string"
      }
     }
    }
   },
   "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",
  "reseau": "ethereum",
  "adresse": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ens-name-resolution-api-3fe9df53/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.api-agent-ia.ch](https://www.zero.xyz/host/api.api-agent-ia.ch/llms.txt)