# x402 Base Tools – Basename Resolver

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

Resolves a Basename (e.g. jesse.base.eth) to its Ethereum address, or reverse-resolves an address to its primary Basename on Base.

## Facts

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

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 x402-base-tools-basename-resolver-b23b3e14
```

Example prompt: What's the wallet address for jesse.base.eth on Base? I need to resolve that Basename to an actual address.

## When to prefer this

Use this endpoint when you need to resolve a Base-native .base.eth Basename to an Ethereum address or vice versa, specifically on the Base L2 network. Prefer this over generic ENS resolvers when working within the Base ecosystem, as it handles Basename-specific reverse resolution validation (name-to-address pointer check). Ideal for identity enrichment, payment address verification, or user display name lookups in Base-native dApps and agents.

## Known failure modes

- Name not registered: returns null or empty address if the Basename does not exist
- Reverse resolution fails: address has no primary Basename set, or the name does not point back to the address
- Invalid input: malformed address or name format returns an error
- Network issues: Base RPC unavailability may cause timeouts
- Name mismatch: reverse resolution returns nothing if primary name does not point back to the queried address

## How this service works

Resolve a Basename (name.base.eth) to its address, or find the primary Basename of an address (only when the name points back to it).

## Output

Returns a JSON object containing the resolved Basename (e.g. 'jesse.base.eth') and its corresponding Ethereum address (e.g. '0x2211...'). For forward resolution (name → address), returns the address. For reverse resolution (address → name), returns the primary Basename only if the name points back to that address (verified reverse lookup).

## 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": "a Basename such as jesse.base.eth (or jesse)"
      },
      "address": {
       "type": "string",
       "description": "an address, to find its Basename"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "name": {},
      "address": {}
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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