# ENS & Basename Resolver

> ENS & Basename Resolver is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Resolves an ENS name or Basename to its wallet address and profile records, or reverses an address to its primary ENS/Basename.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/crypto/ens?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ens-basename-resolver-fb94c6e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cAN-EdQD2amYqlb8ou5K4

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-fb94c6e9
```

Example prompt: Before I send ETH, can you resolve vitalik.eth to its wallet address and also pull up any profile info like avatar or Twitter linked to that ENS name?

## When to prefer this

Use this endpoint when you need to resolve human-readable ENS names or Basenames to wallet addresses before sending funds, displaying identities, or enriching contact records. It also handles reverse lookups from addresses to primary names and retrieves linked social profile data (avatar, Twitter, GitHub). Prefer this over manual on-chain calls when you need a fast, paid, reliable resolution with profile enrichment in a single API call.

## Known failure modes

- ENS name not registered or expired — returns null or empty result
- Address has no primary ENS name set — reverse lookup returns empty
- Malformed input (invalid ENS format or non-hex address) — validation error
- ENS resolver unreachable or network issues — upstream timeout error
- Basename subdomain not found on Base — no record returned

## How this service works

Resolve an ENS name (vitalik.eth) or Basename (jesse.base.eth) to its address and profile records (avatar, url, twitter, github, email, description), or an address to its verified primary name. Use before sending funds to a name or to show who owns a wallet.

## Output

Returns the resolved wallet address for a given ENS name or Basename, along with profile records (avatar, URL, Twitter, GitHub, email, description). For a reverse lookup from an address, returns the verified primary ENS name or Basename associated with that wallet.

## 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",
       "description": "ENS name, Basename or 0x address for reverse lookup"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ens-basename-resolver-fb94c6e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)