# ENS / Basename Resolver (x402 Pay-per-Call)

> ENS / Basename Resolver (x402 Pay-per-Call) is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Resolves an ENS name or Basename to its Ethereum address (or reverse-lookup an address to its name), returning verification status, associated records, and safety metadata.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/v1/name?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ens-basename-resolver-x402-pay-per-call-fdb656d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QIm7MpX5O-3A14XnKNILx

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-basename-resolver-x402-pay-per-call-fdb656d8
```

Example prompt: Can you resolve jesse.base.eth to its Ethereum address and confirm whether the reverse lookup is verified and safe to send funds to?

## When to prefer this

Use this endpoint when an AI agent needs to resolve human-readable ENS or Basename identifiers to Ethereum addresses (or vice versa) without managing API keys, and when paying $0.002 USDC per call via x402 micropayments is acceptable. Prefer this over free public ENS resolvers when operating in an autonomous agent context that already uses x402 for other crypto microdata calls (gas, prices, balances) and needs a unified pay-per-call interface. It is especially valuable when the safe-to-send flag and contract-check metadata are needed alongside the resolution result.

## Known failure modes

- ENS name does not exist or is unregistered — returns null address or error
- Reverse lookup does not match forward resolution — verified=false
- Payment not received or x402 micropayment fails — 402 response before data is returned
- Invalid address format supplied for reverse lookup — schema validation error
- Name recently transferred and DNS propagation lag causes stale result

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

Returns the resolved Ethereum address, direction of resolution (forward/reverse), whether the name is verified (bidirectional match confirmed), ENS records such as avatar and URL, a safe-to-send flag, whether the resolved address is a smart contract on Base, EIP-7702 delegation status, suggested next API endpoints for further onchain data, and a human-readable summary string.

## 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",
     "properties": {
      "name": {
       "type": "string",
       "examples": [
        "vitalik.eth",
        "jesse.base.eth"
       ],
       "maxLength": 255,
       "description": "ENS name or Basename, e.g. vitalik.eth, jesse.base.eth"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "examples": [
        "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
       ],
       "description": "Address for reverse lookup"
      }
     },
     "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",
  "next": [
   "/crypto/contract-info?address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
   "/crypto/wallet-snapshot?wallet=0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
  ],
  "input": "vitalik.eth",
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "records": {
   "url": "https://vitalik.ca",
   "avatar": "eip155:1/erc1155:0xb32979486938aa9694bfc898f35dbed459f44424/10063"
  },
  "summary": "vitalik.eth -> 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 (reverse matches: verified)",
  "verified": true,
  "direction": "forward",
  "checked_at": "2026-10-30T05:40:00Z",
  "is_basename": false,
  "reverse_name": "vitalik.eth",
  "safe_to_send": true,
  "contract_check": {
   "chain": "base",
   "is_contract": false,
   "eip7702_delegated": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ens-basename-resolver-x402-pay-per-call-fdb656d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)