# AgentToll Basename Resolver

> AgentToll Basename Resolver is a paid API for AI agents from agenttoll.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Resolves a Base blockchain name (Basename) to its address, or an address to its primary Basename — bidirectional ENS-style lookup on Base

## Facts

- Endpoint: GET https://agenttoll.app/api/base/name/jesse.base.eth
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-basename-resolver-0f7ef1a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qWbQCsBFrZ0keRmUyIoYP

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 agenttoll-basename-resolver-0f7ef1a4
```

Example prompt: What's the wallet address for jesse.base.eth — can you do a Basename lookup and resolve it to its 0x address?

## When to prefer this

Use this endpoint when you need fast, cheap ($0.001 USDC) bidirectional resolution between Base blockchain names (base.eth Basenames) and 0x addresses. Prefer it over generic ENS resolvers when operating on the Base L2 network specifically. Ideal for agents handling payments, identity verification, or user lookups in Base-native applications.

## Known failure modes

- Name not registered — returns null or 404 if the Basename doesn't exist on Base
- No primary name set — an address may have no reverse record, returning empty result
- Invalid input format — malformed address or unsupported name format returns an error
- Network or registry outage — Base RPC or ENS resolver temporarily unavailable
- Rate limiting — exceeds allowed call frequency, returns 429

## How this service works

Basename resolution both ways: name to address, or address to primary name

## Output

Returns the resolved counterpart: for a Basename input, returns the linked Ethereum (0x) address; for an address input, returns the primary Basename registered to it. Includes the canonical resolution result and any metadata the registry provides.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "nameOrAddress"
     ],
     "properties": {
      "nameOrAddress": {
       "type": "string",
       "description": "A basename (.base.eth optional) or a 0x address"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-basename-resolver-0f7ef1a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.app](https://www.zero.xyz/host/agenttoll.app/llms.txt)