{"uid":"cap_K_AMmJxWmSw0Le9DYCcaO","slug":"ens-name-address-resolver-ethereum-a78f3095","name":"ENS Name & Address Resolver (Ethereum)","description":"ENS on Ethereum: resolve a name (vitalik.eth) to its address and profile records (avatar, description, url, Twitter, GitHub), or pass an address instead to get its primary ENS name. Uses ENS's universal resolver.","url":"https://onchaincheck.dev/eth/ens?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"name":{"type":"string","pattern":"^[^\\s]+\\.[^\\s]+$","description":"ENS name, e.g. vitalik.eth"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address for a reverse lookup instead of name"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"vitalik.eth","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","records":{"url":"https://vitalik.ca","avatar":"https://euc.li/vitalik.eth","com.github":"vbuterin","com.twitter":"VitalikButerin","description":"mi pinxe lo crino tcati"},"registered":true}},"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_hGsnswjsVjW0QE03FOYTa","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 and profile records, or reverse-resolves an Ethereum address to its primary ENS name and profile.","exampleAgentPrompt":"What Ethereum address and social profile records does vitalik.eth resolve to? I need the avatar, Twitter, GitHub, and any description stored in the ENS records.","exampleUseCases":[{"title":"Wallet identity enrichment for display","prompt":"I have the Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — can you find their primary ENS name and pull any avatar or social links stored in their profile?"},{"title":"Sending crypto to a human-readable name","prompt":"Before I send ETH to vitalik.eth, can you confirm the Ethereum address that name resolves to so I know it's correct?"},{"title":"On-chain profile lookup for a dapp","prompt":"Look up the ENS name nick.eth and give me all the profile records attached to it — avatar, website URL, Twitter, GitHub, and description."}],"resultDescription":"Returns a JSON object containing the resolved ENS name, the associated Ethereum address, a set of profile records (avatar URL, description, website URL, Twitter handle, GitHub username), and a boolean indicating whether the name is registered. For reverse lookups by address, returns the primary ENS name and accompanying profile records.","failureModes":["ENS name not registered — returns registered: false with no address or records","Malformed ENS name or address format — schema validation rejects the request","Name registered but no records set — records object present but fields are empty or null","Network or resolver timeout when querying the Ethereum mainnet","Payment failure via x402 protocol resulting in 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need a direct, paid, on-demand ENS resolution without running your own Ethereum node or managing RPC providers. It handles both forward (name→address) and reverse (address→name) lookups in a single call and also returns rich profile metadata (avatar, social handles, URL) that standard RPC calls require additional steps to retrieve. Prefer it over generic RPC endpoints when you want profile records alongside address resolution in one request.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:51.546Z","isFirstParty":false,"canonicalSlug":"ens-name-address-resolver-ethereum-a78f3095"}