# 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).

Bidirectional resolution between Base blockchain addresses and Basenames (ENS-style .base.eth names)

## Facts

- Endpoint: GET https://agenttoll.app/api/base/name/:address
- 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-54e26d5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_utsIMd1KaHQl8PCLRnxaA

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-54e26d5b
```

Example prompt: What's the wallet address for vitalik.base.eth, and what's the primary Basename registered to 0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97?

## When to prefer this

Use this endpoint when you need fast, cheap bidirectional resolution between Base blockchain addresses and Basenames. Prefer it over general ENS resolvers when working specifically on the Base L2 chain, or when your agent needs to enrich wallet data with human-readable identities (or vice versa) at $0.001 per call with x402 micropayment support.

## Known failure modes

- Name not registered — returns null or empty address if the Basename does not exist
- No primary name set — wallet address has no Basename associated, returns null
- Invalid input format — malformed address or unsupported name format may return an error
- Network or registry downtime — Base RPC or ENS registry unavailable
- Rate limiting or payment failure — x402 payment not accepted or insufficient USDC

## 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 associated 0x Ethereum address; for a 0x address input, returns the primary Basename registered to that wallet. If no resolution is found, likely returns null or an empty result for that field.

## 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-54e26d5b/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)