# JustAName ENS Resolver

> JustAName ENS Resolver is a paid API for AI agents from api.justaname.id, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Resolves one or more ENS names into their associated addresses, text records, and content hashes, with batch support for up to 50 names and per-name chain scoping.

## Facts

- Endpoint: GET https://api.justaname.id/ens/v2/resolve
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-justaname-id-4ac652f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9y-MUp3elSboqcJfLvKrn

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-justaname-id-4ac652f6
```

Example prompt: What wallet address does vitalik.eth resolve to, and can you also grab its text records and content hash?

## When to prefer this

Use this endpoint when you need to resolve one or more ENS names to their underlying addresses, text records, or content hashes, especially when you need chain-scoped resolution or batch processing of up to 50 names in one call. Prefer over generic ENS libraries when you need a hosted API with payment support.

## Known failure modes

- ENS name not found or unregistered — returns empty or null resolution
- Invalid ENS name format — returns 400 error
- Batch size exceeds 50 names — returns error
- Chain ID not supported — returns scoping error
- Network or provider timeout — returns 503 or timeout error

## How this service works

Resolves an ENS name into its addresses, text records, and content hash, with batch support up to 50 names and per-name chain scoping via interop addresses.

## Output

Returns the resolved wallet addresses (including cross-chain interop addresses), text records (e.g. avatar, email, website), and content hash associated with the queried ENS name(s). Supports batching up to 50 names in a single call.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ens": [
    "vitalik.eth",
    "nick.eth"
   ],
   "resolveChain": "1"
  }
 }
}
```

## 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": {
    "body": {},
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE",
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "type": "string"
    },
    "queryParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "enum": [
      "json",
      "text"
     ]
    },
    "format": {
     "type": "string"
    },
    "example": {}
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "records": {
   "texts": [
    {
     "key": "url",
     "value": "https://vitalik.ca"
    },
    {
     "key": "avatar",
     "value": "eip155:1/erc721:0x..."
    }
   ],
   "contentHash": {
    "decoded": "ipns://k51qzi5uqu5dgox2z23r6e99oqency055a6xt92xzmyvpz8mwz5ycjavm0u2u8",
    "protocolType": "ipns"
   }
  },
  "fullName": "vitalik.eth",
  "resolvedAddress": {
   "value": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
   "coinType": "60"
  }
 }
}
```

## More

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