{"uid":"cap_AXiDmQ_9mU5_q9gMELW83","slug":"openverbs-ens-records-lookup-43e3a777","name":"OpenVerbs ENS Records Lookup","description":"Read an ENS name's address plus its text records (avatar, url, email, description, com.twitter, com.github and more) in one call, live from the resolver on Ethereum mainnet. Pass `keys` to fetch specific records, or omit it for a sensible default set. Only records that are set are returned. Live reads with automatic endpoint fallback.","url":"https://chain.openverbs.com/v1/ens-records","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":["name"],"properties":{"keys":{"type":"array","items":{"type":"string"},"maxItems":12,"description":"Text-record keys to read (max 12). Omit for defaults: avatar, description, url, email, com.twitter, com.github, org.telegram, com.discord."},"name":{"type":"string","description":"ENS name, e.g. vitalik.eth."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7dsH0TmwBlvKBsedqOpmA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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 to its Ethereum address and text records (avatar, URL, email, Twitter, GitHub, etc.) in a single live call from the Ethereum mainnet resolver.","exampleAgentPrompt":"Look up the Ethereum address, avatar, Twitter, GitHub, and email linked to vitalik.eth — fetch all the default text records in one shot.","exampleUseCases":[{"title":"Resolve ENS identity for onboarding","prompt":"I have a new user who signed up with the handle brantly.eth — can you pull their Ethereum address plus whatever contact info and social links are set on that ENS name?"},{"title":"Display web3 profile card","prompt":"Build a profile card for nick.eth: grab their avatar, description, website URL, Twitter, and GitHub from their ENS records."},{"title":"Verify ENS contact details before payment","prompt":"Before I send ETH, can you confirm the address that rainbowwallet.eth resolves to and check whether they have an email or Discord set in their ENS records?"}],"resultDescription":"Returns a JSON object containing the resolved Ethereum address for the ENS name and any text records that are set (e.g. avatar, description, url, email, com.twitter, com.github, org.telegram, com.discord). Only records with values are included in the response. Records are read live from the Ethereum mainnet ENS resolver with automatic endpoint fallback.","failureModes":["ENS name does not exist or is unregistered — empty or error response","ENS name is expired — resolver may return no records","No records set for the requested keys — empty records object returned","Invalid ENS name format — validation error","Rate limiting or RPC node unavailability — fallback attempted, then error","Network timeout on slow Ethereum node response"],"whenToPreferThis":"Use this endpoint when you need to resolve an ENS name to its Ethereum address AND retrieve associated text records (social handles, avatar, email, website) in a single call. It reads live from mainnet with automatic fallback, making it more reliable than a single-node RPC call. Prefer this over generic RPC calls when you want structured, pre-parsed ENS profile data rather than raw ABI-encoded resolver responses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:10.802Z","isFirstParty":false}