{"uid":"cap_dgDkHcYXjdrOx6anogjfY","slug":"ens-name-address-lookup-ae60ee9b","name":"ENS Name & Address Lookup","description":"Use when you need to resolve an ENS name to an address, reverse-resolve an address to its ENS name, or read an ENS avatar and profile records. Do not use for registering or renewing names, or non-ENS naming such as Solana SNS. Returns JSON with an ENS lookup on Ethereum in one call: the address of a name, the verified primary name of an address (reverse), the avatar and text records such as url, twitter and github for 0.005 USDC per call. Typical response time 2000 ms (p95). Category: Data.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/ens-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":[],"properties":{"name":{"type":"string","maxLength":255,"minLength":3,"description":"ENS name to resolve, e.g. vitalik.eth (send name or address, not both)"},"texts":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,64}$"},"maxItems":10,"minItems":1,"description":"Text record keys to read (avatar, url, description, com.twitter, com.github and email when omitted), e.g. [\"url\", \"com.github\"]"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Ethereum address to reverse-resolve, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 (send name or address, not both)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["name","address","primaryName","avatar","avatarUrl","texts","resolver","chain","blockNumber"],"properties":{"name":{"type":["string","null"]},"next":{"type":"object","required":["service","tool","method","url","useWhen","sample"],"properties":{"url":{"type":"string","description":"Paid route of the next call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"enum":["GET","POST"],"type":"string"},"sample":{"type":"string","description":"Free fixed sample of the whole family"},"service":{"type":"string","description":"Service id of the suggested next paid call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"chain":{"type":"string","const":"ethereum"},"texts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","null"]}},"avatar":{"type":["string","null"]},"address":{"type":["string","null"]},"resolver":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]},"blockNumber":{"type":"number"},"primaryName":{"type":["string","null"]}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"name":"vitalik.eth","chain":"ethereum","texts":{"url":"https://vitalik.ca","email":null,"avatar":"https://euc.li/vitalik.eth","com.github":"vbuterin","com.twitter":"VitalikButerin","description":"mi pinxe lo crino tcati"},"avatar":"https://euc.li/vitalik.eth","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","resolver":"0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63","avatarUrl":"https://euc.li/vitalik.eth","blockNumber":26216461,"primaryName":"vitalik.eth"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d7GSmox97hsoO7D2BMCzN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an ENS name to an Ethereum address (or reverse-resolves an address to its primary ENS name) and returns avatar, profile text records, and metadata in one call.","exampleAgentPrompt":"Look up vitalik.eth for me — I need its Ethereum address, avatar, and also grab its Twitter and GitHub text records.","exampleUseCases":[{"title":"Resolve ENS name to wallet address","prompt":"What Ethereum address does vitalik.eth resolve to? Also grab any avatar and social profile links attached to it."},{"title":"Reverse-resolve wallet address to ENS name","prompt":"Can you find the primary ENS name and profile for the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?"},{"title":"Fetch ENS profile for identity enrichment","prompt":"I have the ENS name brantly.eth — can you pull its full profile including avatar, URL, Twitter handle, and GitHub username?"}],"resultDescription":"Returns a JSON object containing: the resolved Ethereum address (for forward lookups), the verified primary ENS name (for reverse lookups), the avatar content hash and rendered avatar URL, requested text records (url, com.twitter, com.github, email, description, etc.), the resolver contract address, the Ethereum chain identifier, and the block number at which the data was fetched. Also includes a suggested next-call hint for chaining queries.","failureModes":["ENS name not found or not registered — returns null address","Address has no reverse record set — primaryName is null","Text records requested but not set on the name — returns empty or null values","Both name and address provided simultaneously — returns validation error","Invalid Ethereum address format — schema validation error","ENS name shorter than 3 characters — schema validation error","Upstream Ethereum RPC timeout — may return 5xx after ~2s","Payment not attached or insufficient — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to resolve ENS names to Ethereum addresses, reverse-resolve addresses to human-readable ENS names, or fetch ENS profile data (avatar, social links, URLs) in a single low-latency call. Do not use for registering or renewing ENS names, for Solana SNS or other non-Ethereum naming systems, or for non-ENS Ethereum domain systems like Unstoppable Domains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:50:08.693Z","isFirstParty":false,"canonicalSlug":"ens-name-address-lookup-ae60ee9b"}