# Base Reads – Basename Resolver

> Base Reads – Basename Resolver is a paid API for AI agents from base-reads-api.rafliyaputra.deno.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-01).

Resolves a .base.eth Basename to its associated address and resolver, or looks up a wallet address's verified primary Basename.

## Facts

- Endpoint: GET https://base-reads-api.rafliyaputra.deno.net/base/basename?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-reads-basename-resolver-e4413603
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ayE6GFIHzbYUcVvKrkit5

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 base-reads-basename-resolver-e4413603
```

Example prompt: What wallet address does jesse.base.eth resolve to, and which resolver contract handles it?

## When to prefer this

Choose this endpoint when you need on-chain, deterministic resolution of Base (Coinbase L2) Basenames — either forward lookup (name → address) or reverse lookup (address → name). Prefer this over generic ENS resolvers when the name uses the .base.eth suffix and is registered on the Base L2 Basename registry specifically. Ideal for agents that need to verify wallet identities, enrich transaction data with human-readable names, or confirm ownership before executing payments.

## Known failure modes

- Name not found: Basename does not exist or has not been registered — empty or null response
- Address has no primary Basename: wallet address exists on Base but has no verified primary Basename set
- Invalid address format: address parameter does not match ^0x[0-9a-fA-F]{40}$ pattern — schema validation error
- Neither name nor address provided: both optional query params omitted — likely 400 or empty response
- Payment failure: x402 payment of $0.003 USDC not completed — 402 response returned before data
- Network/RPC error: Base node temporarily unavailable — 5xx response

## How this service works

Pay-per-call read API for Base over x402 v2. Deterministic data, no advice.

## Output

Returns a JSON object containing the resolved Basename (e.g. 'jesse.base.eth'), the corresponding wallet address (checksummed 0x format), and the ENS-compatible resolver contract address handling the name.

## 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": [],
     "properties": {
      "name": {
       "type": "string",
       "description": "Basename to resolve, with or without the .base.eth suffix (give name or address)"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Base address whose verified primary Basename to look up (give name or address)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "jesse.base.eth",
  "address": "0x2211d1d0020daea8039e46cf1367962070d77da9",
  "resolver": "0xc6d566a56a1aff6508b41f6c90ff131615583bcd"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-reads-basename-resolver-e4413603/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base-reads-api.rafliyaputra.deno.net](https://www.zero.xyz/host/base-reads-api.rafliyaputra.deno.net/llms.txt)