# Base Basename Resolver

> Base Basename Resolver is a paid API for AI agents from ca-tax-api-mainnet.lxtap.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23).

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

## Facts

- Endpoint: GET https://ca-tax-api-mainnet.lxtap.workers.dev/base/basename?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-basename-resolver-94a922b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TfhjiaqHxNH0t0Db_XB9c

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-94a922b6
```

Example prompt: What wallet address and social profiles are linked to jesse.base.eth?

## When to prefer this

Use this endpoint when you need to resolve a human-readable Base name (Basename / .base.eth) to a wallet address or retrieve social profile metadata attached to a Basename. Prefer this over generic ENS resolvers when the name is specifically on Base L2. Ideal for pre-filling recipient addresses, displaying web3 user profiles, or verifying identity before a transaction.

## Known failure modes

- Basename not registered: returns null or empty address
- Invalid name format: rejected by pattern validation (must match ^[a-zA-Z0-9-]+(\.base(\.eth)?)?$)
- Basename has no profile records set: address resolves but profile fields are empty
- Network or RPC errors from Base chain: transient 5xx response
- Payment failure: x402 payment not processed, returns 402

## How this service works

Pay-per-call data for AI agents, paid in USDC on Base with x402: token risk checks (rug check) on Base, Ethereum, Arbitrum, Optimism, Polygon and Solana, onchain reads (balances, transactions, gas, contracts, NFTs, whale trades, new pools, ENS and Basenames), ECB exchange rates, and Canadian sales tax and business days.

## Output

Returns the resolved Base (0x) wallet address for the Basename, along with profile record fields: avatar image URL, text description, website URL, Twitter handle, and GitHub username — whichever records the owner has set.

## 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-94a922b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ca-tax-api-mainnet.lxtap.workers.dev](https://www.zero.xyz/host/ca-tax-api-mainnet.lxtap.workers.dev/llms.txt)