$ man ens-resolve
/ens-resolve
PRICE / CALL
$0.03
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
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.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| query | string | — | required |
| text_records | array | — | 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.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
ADJACENT — other endpoints in edgemarket
| endpoint | description | price |
|---|---|---|
| bridge-rates | Compares cross-chain bridge quotes to find the cheapest route between chains, powered by LiFi. | $0.03 |
| dao-proposal-monitor | Monitors DAO governance proposals on Snapshot.org for any space. | $0.03 |
| defi-llama | DefiLlama API / DeFi TVL protocol lookup. | $0.02 |
| defi-llama-api | Looks up DeFi protocol fundamentals from DefiLlama, resolving protocol TVL, category, chains, token symbol, and protocol metadata. | $0.02 |
| defi-llama-protocol | Looks up any DeFi protocol's TVL and metadata from DefiLlama. | $0.02 |
| defi-tvl | DeFi TVL API / total value locked by protocol. | $0.02 |
| defillama | DefiLlama protocol TVL lookup / DeFi protocol metadata. | $0.02 |
| gas-api | Estimates blockchain gas fees with EIP-1559 tiers for Base, Ethereum, Optimism, and Arbitrum. | $0.02 |
SEE ALSO