# BaseLens Name Resolution (Basename/ENS Resolve)

> BaseLens Name Resolution (Basename/ENS Resolve) is a paid API for AI agents from baselens-api.vercel.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-31).

Resolves an ENS or Basename (e.g. jesse.base.eth) to its corresponding Ethereum/Base wallet address and avatar, or reverse-resolves a 0x address to its name.

## Facts

- Endpoint: GET https://baselens-api.vercel.app/v1/name?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/baselens-name-resolution-basename-ens-resolve-1fdb30c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3iIwhnyaKqSbDLySaT32n

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 baselens-name-resolution-basename-ens-resolve-1fdb30c3
```

Example prompt: What's the wallet address for jesse.base.eth on Base? Resolve it so I can send a transaction.

## When to prefer this

Use this endpoint when you need to resolve a human-readable blockchain name (Basename or ENS) to a 0x address, or reverse-resolve an address to a name, specifically on the Base L2 network. Prefer this over generic ENS resolvers when working within the Base ecosystem, as it natively handles .base.eth names. It requires no API key and charges a tiny $0.001 USDC per call via x402.

## Known failure modes

- Name not found or unregistered — resolved: false returned
- Invalid ENS/Basename format causes a 400-level error
- Address provided for reverse-resolve has no associated name, returning null name
- Network issues with Base RPC cause lookup failure
- Payment (x402) failure if USDC balance is insufficient

## How this service works

Base address, ERC-20 balance, token price, recent transfers, Basename/ENS resolve, contract verification, tx summaries and gas over x402 and MCP. $0.001–$0.004 USDC per call, no API key.

## Output

Returns a JSON object with the resolved 0x wallet address, the Basename/ENS query string, the resolution type (forward or reverse), the avatar image URL if one is set, and a boolean indicating whether resolution succeeded.

## 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",
       "description": "ENS or Basename, e.g. jesse.base.eth or vitalik.eth"
      },
      "address": {
       "type": "string",
       "description": "Alternative: 0x address to reverse-resolve"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "forward",
  "query": "jesse.base.eth",
  "avatar": "https://…",
  "address": "0x2211d1D0020DAEA8039E46Cf1367962070d77DA9",
  "resolved": true,
  "baseAddress": "0x2211…7DA9"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/baselens-name-resolution-basename-ens-resolve-1fdb30c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from baselens-api.vercel.app](https://www.zero.xyz/host/baselens-api.vercel.app/llms.txt)