# Base Basename Resolver

> Base Basename Resolver is a paid API for AI agents from onchaincheck.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Resolves a Basename (e.g. jesse.base.eth) to its Base wallet address and on-chain profile records including avatar, description, URL, Twitter, and GitHub.

## Facts

- Endpoint: GET https://onchaincheck.dev/base/basename?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-basename-resolver-24f80988
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-SH71dYk8WXr4KdKBOqqm

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-basename-resolver-24f80988
```

Example prompt: What is the Base wallet address and profile info for jesse.base.eth?

## When to prefer this

Use this endpoint when you need to resolve a Base-specific .base.eth name to a wallet address or retrieve the on-chain social profile attached to it. Prefer this over generic ENS resolvers when the target name is on Base (name.base.eth) rather than Ethereum mainnet (.eth). It accepts flexible input formats (jesse, jesse.base, jesse.base.eth) making it easy to use from user-provided input.

## Known failure modes

- Basename not registered — returns registered: false or null address
- Invalid name format — rejected by query param pattern validation
- Name exists but has no profile records set — records fields will be empty or null
- Network/RPC timeout — service may return 5xx error
- Typo in name — resolves to wrong or unregistered name

## How this service works

Resolve a Basename (name.base.eth) to its Base address and profile records (avatar, description, url, Twitter, GitHub). Accepts "jesse", "jesse.base" or "jesse.base.eth".

## Output

Returns a JSON object containing the resolved Base wallet address, the full .base.eth name, on-chain profile records (avatar image URL, description, website URL, Twitter handle, GitHub handle), the resolver contract address, and a boolean indicating whether the name is registered.

## 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",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "pattern": "^[a-zA-Z0-9-]+(\\.base(\\.eth)?)?$",
       "description": "Basename"
      }
     },
     "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": "jesse.base.eth",
  "address": "0x2211d1D0020DAEA8039E46Cf1367962070d77DA9",
  "records": {
   "url": "jesse.xyz",
   "avatar": "https://zku9gdedgba48lmr.public.blob.vercel-storage.com/basenames/avatar/jesse.base.eth/1722020142962/cryptopunk-diuDROjlL5OLY6EcC5keHTsNAiWMSL.png",
   "com.github": "jessepollak",
   "com.twitter": "jessepollak",
   "description": "base.eth builder #001"
  },
  "resolver": "0xC6d566A56A1aFf6508b41f6c90ff131615583BCD",
  "registered": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-basename-resolver-24f80988/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onchaincheck.dev](https://www.zero.xyz/host/onchaincheck.dev/llms.txt)