Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man ens-resolve

/ens-resolve(1)

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 ens resolver / ethereum name service lookup
SYNOPSIS
POST https://x402.org/v1/ens-resolve
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

ENS resolver / Ethereum Name Service lookup. Forward (vitalik.eth → 0x...address) and reverse (0x... → primary ENS name) with text records (avatar, url, description, com.twitter, com.github, email, org.telegram).

INPUTrequest schema
propertytypedescriptionreq?
querystringENS name (vitalik.eth) or 0x address.required
text_recordsarrayOptional text record keys to fetch (max 15). Default: avatar, url, description, com.twitter, com.github, email, org.telegram.optional
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.org/v1/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 once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the ens-resolve tool to ..."
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-ratesCross-chain bridge rate aggregator.$0.03
dao-proposal-monitorSnapshot.org DAO proposal monitor.$0.03
defi-llama-protocolDefiLlama protocol lookup — TVL, chain breakdown, current TVL, 24h/7d/30d changes, audits, parent protocol, categories.$0.02
gas-now-baseGas oracle / EIP-1559 fee estimator.$0.02
gas-priceGas price API / EIP-1559 fee estimator / Base + Ethereum + Optimism + Arbitrum gas tracker / pre-tx cost estimator.$0.02
token-priceCrypto token price API / CoinGecko wrapper.$0.02
tx-receipt-decodeEVM transaction receipt decoder / log decoder / event log reader / Etherscan tx debug / receipt parser / Basescan tx explainer / tenderly…$0.02
tx-simulate-swapTx simulate swap / pre-trade quote / DEX swap simulator / 1inch + LlamaSwap quote / would-it-succeed check.$0.02
SEE ALSO
agentutility(7) · edgemarket(7) · x402(7) · mcp(7) · llms.txt · registry.json · bazaar.x402.org