Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man ens-resolve

/ens-resolve

agentutility / edge-market / ens-resolve
PRICE / CALL
$0.03
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarket
CATEGORY
utilities
STATUS
live
NAME
ens-resolve resolves ens names in both directions: forward (vitalik.eth to address) and reverse (address to primary ens)
SYNOPSIS
POST https://x402.agentutility.ai/ens-resolve
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Resolves ENS names in both directions: forward (vitalik.eth to address) and reverse (address to primary ENS). Optional text records include avatar, twitter, github, url, and email. Use it as an ENS resolver, ENS lookup, or Ethereum Name Service lookup.

INPUTrequest schema
propertytypedescriptionreq?
querystringrequired
text_recordsarrayoptional
OUTPUTresponse shape
fieldtypedescription
modestringLookup direction performed: 'forward' for name-to-address, 'reverse' for address-to-name.
ens_namestringENS name resolved or queried (e.g. vitalik.eth), including subdomains when applicable.
addressstringEthereum address (0x-prefixed, 20 bytes) tied to the ENS name.
text_recordsobjectMap of ENS text record keys to values (avatar, url, description, com.twitter, com.github, email, org.telegram).
sourcestringResolver source used for the lookup (e.g. ENS public resolver contract or RPC endpoint).
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/ens-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 ens-resolve tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
ensethereumcryptoname-serviceweb3
methods
POST
cluster
edgemarket
price
$0.03 USDC per call
ADJACENTother endpoints in edgemarket
endpointdescriptionprice
bridge-ratesCompares cross-chain bridge quotes to find the cheapest route between chains, powered by LiFi.$0.03
dao-proposal-monitorMonitors DAO governance proposals on Snapshot.org for any space.$0.03
defi-llamaDefiLlama API / DeFi TVL protocol lookup.$0.02
defi-llama-apiLooks up DeFi protocol fundamentals from DefiLlama, resolving protocol TVL, category, chains, token symbol, and protocol metadata.$0.02
defi-llama-protocolLooks up any DeFi protocol's TVL and metadata from DefiLlama.$0.02
defi-tvlDeFi TVL API / total value locked by protocol.$0.02
defillamaDefiLlama protocol TVL lookup / DeFi protocol metadata.$0.02
gas-apiEstimates blockchain gas fees with EIP-1559 tiers for Base, Ethereum, Optimism, and Arbitrum.$0.02
SEE ALSO
agentutility · edgemarket · x402 · mcp · llms.txt · registry.json · bazaar.x402.org