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 — resolves coinbase basenames (.base.eth) to ethereum addresses and back, reading the base mainnet l2 resolver on-chain (no gas, no wallet)

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Resolves Coinbase Basenames (.base.eth) to Ethereum addresses and back, reading the Base mainnet L2 Resolver on-chain (no gas, no wallet). Forward: pass a basename like 'alice.base.eth' (bare names are auto-suffixed with .base.eth) to get the registered address plus avatar / url / com.twitter / com.github / email / com.discord text records (override with `text_records`). Reverse: pass a 0x address to get the primary basename, if any. Useful for agent-payment flows that need to translate human names to Base addresses. Use it as a basename resolver, .base.eth lookup, Base name service, or on-chain name resolution.

INPUT — request schema

property	type	description	req?
query	string	Either a basename ('alice.base.eth', or bare 'alice' which is auto-suffixed) for forward resolution, OR a 0x-prefixed Ethereum address for reverse resolution.	required
text_records	array	Optional list of 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.agentutility.ai/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 the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the basename-resolve tool from your MCP-aware agent.

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	Resolves an ERC-8004 agentId to its on-chain owner, agentURI, and agent card JSON.	$0.005
arbitrage-spread	Finds the cross-exchange arbitrage spread for any CoinGecko-listed coin.	$0.005
cid-fetch	Fetches the content behind an IPFS CID and optional path through public gateways, returning text, JSON, or base64 with a 5 MB cap.	$0.005
current-balance	Reads a wallet's current ERC-20 token balance with a read-only balanceOf call on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, or Ava…	$0.005
defi-yield-pools	Filters and ranks thousands of DeFi yield-bearing pools by APY across every chain DeFiLlama tracks.	$0.005
erc20-balance	Reads an ERC-20 token balance on-chain across any supported EVM chain, including Base, Ethereum, Arbitrum, Optimism, and Polygon.	$0.005
erc20-metadata	Reads ERC-20 token metadata: name(), symbol(), decimals(), and totalSupply() in parallel via public RPC on Base, Ethereum, Arbitrum, Opti…	$0.005
flagged-tokens	Feed of flagged risky Solana tokens: thin liquidity, extreme moves, sell pressure, very new pairs, and missing profile context.	$0.005