$ man ens-resolve
/ens-resolve(1)
PRICE / CALL
$0.03
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
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).
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| query | string | ENS name (vitalik.eth) or 0x address. | required |
| text_records | array | Optional text record keys to fetch (max 15). Default: avatar, url, description, com.twitter, com.github, email, org.telegram. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| mode | string | Lookup direction performed: 'forward' for name-to-address, 'reverse' for address-to-name. |
| ens_name | string | ENS name resolved or queried (e.g. vitalik.eth), including subdomains when applicable. |
| address | string | Ethereum address (0x-prefixed, 20 bytes) tied to the ENS name. |
| text_records | object | Map of ENS text record keys to values (avatar, url, description, com.twitter, com.github, email, org.telegram). |
| source | string | Resolver source used for the lookup (e.g. ENS public resolver contract or RPC endpoint). |
EXAMPLES — two 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
ADJACENT — other endpoints in edgemarket
| endpoint | description | price |
|---|---|---|
| bridge-rates | Cross-chain bridge rate aggregator. | $0.03 |
| dao-proposal-monitor | Snapshot.org DAO proposal monitor. | $0.03 |
| defi-llama-protocol | DefiLlama protocol lookup — TVL, chain breakdown, current TVL, 24h/7d/30d changes, audits, parent protocol, categories. | $0.02 |
| gas-now-base | Gas oracle / EIP-1559 fee estimator. | $0.02 |
| gas-price | Gas price API / EIP-1559 fee estimator / Base + Ethereum + Optimism + Arbitrum gas tracker / pre-tx cost estimator. | $0.02 |
| token-price | Crypto token price API / CoinGecko wrapper. | $0.02 |
| tx-receipt-decode | EVM transaction receipt decoder / log decoder / event log reader / Etherscan tx debug / receipt parser / Basescan tx explainer / tenderly… | $0.02 |
| tx-simulate-swap | Tx simulate swap / pre-trade quote / DEX swap simulator / 1inch + LlamaSwap quote / would-it-succeed check. | $0.02 |
SEE ALSO