Name: basename-resolve
Price: 0.005 USDC
Availability: InStock

$ man basename-resolve

agentutility / edge-market / basename-resolve

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgemarket

CATEGORY

uncategorized

STATUS

● live

NAME

basename-resolve — basename resolver / coinbase basenames / .base.eth lookup / base name service / on-chain name resolution

SYNOPSIS

POST https://x402.org/v1/basename-resolve
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Basename resolver / Coinbase Basenames / .base.eth lookup / Base name service / on-chain name resolution. Forward: pass a basename like 'alice.base.eth' (bare names are auto-suffixed with .base.eth) → returns the registered Ethereum address. Reverse: pass a 0x address → returns the primary basename, if any. Also returns avatar / url / com.twitter / com.github / email / com.discord text records on forward lookups (override with `text_records`). Reads from Base mainnet L2 Resolver 0xC6d566A56A1aFf6508b41f6c90ff131615583BCD via a static eth_call (no gas, no wallet, no API key). Useful for agent-payment flows that need to translate human names to Base addresses.

INPUT — request schema

property	type	description	req?
query	string	A basename ('alice.base.eth' or bare 'alice') for forward, OR a 0x address for reverse.	required
text_records	array	Optional text-record keys to fetch on forward lookups. Default: avatar/url/description/com.twitter/com.github/email/com.discord. Cap 12 keys.	optional

OUTPUT — response shape

field	type	description
mode	string	Either 'forward' (basename to address) or 'reverse' (address to basename), reflecting which lookup ran.
name	stringnull	Resolved basename (e.g. 'alice.base.eth') for reverse mode, or the queried name for forward mode; null if unset.
address	stringnull	Ethereum address registered to the basename in forward mode, or the queried address in reverse mode; null if unset.
text_records	object	Map of requested text record keys (avatar, url, com.twitter, etc.) to their on-chain string values for forward lookups.
network	string	Chain the resolver was queried on, always 'base' (Base mainnet L2).
resolver	string	Address of the Base L2 Resolver contract used (0xC6d566A56A1aFf6508b41f6c90ff131615583BCD).
rpc_used	string	RPC endpoint URL that served the eth_call against the resolver.
source	string	Identifier for the data origin, e.g. 'base-l2-resolver' indicating on-chain Base mainnet read.
attribution	string	Credit string naming Coinbase Basenames as the underlying name service.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/basename-resolve \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the basename-resolve tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: basenamebaseensname-servicecoinbaseresolveraddress
methods: POST
cluster: edgemarket
price: $0.005 USDC per call

ADJACENT — other endpoints in edgemarket

endpoint	description	price
agent-card-resolve	Agent card resolver / ERC-8004 Identity Registry lookup / Trustless Agents / agentId → owner + agentURI / A2A identity / agent.json fetch…	$0.005
arbitrage-spread	Cross-exchange arbitrage spread / max-min price / CEX price dispersion / spread % calculator.	$0.005
defi-yield-pools	DeFi yield pools / APY aggregator / yield-farming opportunities / DeFiLlama yields / cross-protocol APY ranking / stablecoin yields / LP…	$0.005
ipfs-fetch	IPFS fetch / IPFS gateway / Web3 storage retrieval / NFT metadata fetcher / Filecoin gateway / decentralized content / pinned-content reader.	$0.005
price-impact	Price-impact / slippage estimator / DEX swap size impact / size-keyed quote / depth simulation.	$0.005
safe-multisig-status	Safe multisig status / Gnosis Safe info / Safe owners / Safe threshold / Safe pending queue / DAO treasury wallet / Safe wallet lookup.	$0.005
stablecoin-monitor	Stablecoin monitor.	$0.005
stablecoin-peg	Stablecoin peg monitor / depeg detector.	$0.005

/basename-resolve(1)