{"uid":"cap_N1oczfJbTv_nylgi-nnY-","slug":"ens-name-resolution-afba9f56","name":"ENS Name Resolution","description":"Use when an agent has a name where it needs an address, or the other way round, before it can act: resolves an ENS name to its address or an address to its primary ENS name, read straight from Ethereum mainnet, with found telling you when there is no record. Do not use to check an address is well formed (/v1/util/address) or that it is a wallet (/v1/evm/is-contract). No API key.","url":"https://flat-rate-llm.kikoribera03.workers.dev/v1/evm/ens?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"ENS name to resolve, such as vitalik.eth."},"address":{"type":"string","description":"Address to reverse-resolve. Use instead of name."}}},"responseSchema":{"type":"object","properties":{"name":{"type":"string"},"found":{"type":"boolean"},"address":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JUQdlIV0v14EvRnAWc1QR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an ENS name (e.g. vitalik.eth) to its Ethereum address, or reverse-resolves an Ethereum address back to its primary ENS name, reading directly from Ethereum mainnet.","exampleAgentPrompt":"What Ethereum address does vitalik.eth resolve to? Read it directly from Ethereum mainnet.","exampleUseCases":[{"title":"ENS name to address before transaction","prompt":"I want to send ETH to nick.eth — what's the actual Ethereum wallet address that resolves to?"},{"title":"Reverse lookup for wallet identity","prompt":"I have this Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — does it have a primary ENS name registered?"},{"title":"Validate ENS name before contract interaction","prompt":"Before I call this smart contract, can you check whether uniswap.eth actually resolves to a valid address on mainnet?"}],"resultDescription":"Returns a JSON object with three fields: 'name' (the ENS name), 'address' (the resolved Ethereum hex address), and 'found' (boolean indicating whether a record was found). For forward resolution, address is populated; for reverse resolution, name is populated.","failureModes":["ENS name not registered or has no address record — returns found: false","Address has no primary ENS name set — returns found: false with empty name","Invalid ENS name format — may return an error or found: false","Invalid Ethereum address format — likely returns an error response","Ethereum mainnet RPC unavailable — may return a 500 or timeout error","ENS name exists but resolver is not configured — returns found: false"],"whenToPreferThis":"Choose this endpoint when you need a simple, pay-per-call ENS resolution without setting up an Ethereum node, Web3 provider credentials, or managing API keys. Ideal for agents that occasionally need to resolve ENS names or reverse-lookup addresses on Ethereum mainnet without integrating a full blockchain SDK. Prefer this over on-chain RPC calls when your agent lacks direct mainnet access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:09.293Z","isFirstParty":false,"canonicalSlug":"ens-name-resolution-afba9f56"}