# APEX Basename Lookup

> APEX Basename Lookup is a paid API for AI agents from apexfaucet.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Resolves a Basename (name.base.eth) to its Ethereum address and profile records, or reverse-resolves an address to its verified primary Basename on Base.

## Facts

- Endpoint: GET https://apexfaucet.xyz/api/x402/basename?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apex-basename-lookup-ea2da6b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z79w2EPsUxcnp35tTgeqf

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 apex-basename-lookup-ea2da6b9
```

Example prompt: What Ethereum address does jesse.base.eth resolve to, and can you also grab their avatar and GitHub from the Basenames registry?

## When to prefer this

Use this endpoint when you need to resolve Base-native identities (name.base.eth) to wallet addresses or vice versa, especially when you also want profile metadata like avatar or social links. It reads directly from the Basenames registry on Base L2 with forward-verification to prevent spoofed reverse records, making it more trustworthy than a naive reverse lookup.

## Known failure modes

- Basename not found or not registered — returns empty or null result
- Address has no primary Basename set — reverse lookup returns null
- Invalid input format (neither valid Basename nor 0x address) — may return an error
- Profile fields missing if owner hasn't set them — partial record returned
- Payment failure if USDC balance is insufficient on Base

## How this service works

Basename lookup: name.base.eth to address, or an address to its verified primary name, with profile records. Base name lookup: a Basename (name.base.eth) to its address, owner and public profile records (avatar, url, X, GitHub), or an address to its primary Basename, forward-verified so a spoofed reverse record is never trusted. Read on Base from the Basenames registry. Paid in USDC on Base.

## Output

Returns the resolved Ethereum address, owner address, and public profile records (avatar, URL, X/Twitter handle, GitHub) for a given Basename, or the verified primary Basename for a given 0x address. Forward verification ensures spoofed reverse records are never trusted.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "A Basename (alice or alice.base.eth) or a 0x address."
      }
     }
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apex-basename-lookup-ea2da6b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apexfaucet.xyz](https://www.zero.xyz/host/apexfaucet.xyz/llms.txt)