{"uid":"cap_8fO-XBTdwjqDvr8GpXS1a","slug":"ens-basename-lookup-api-x402-6c055d3c","name":"ENS & Basename Lookup API (x402)","description":"Invoice-to-JSON, on-chain tools (transaction explainer + payment check, wallet profile, contract ABI, ERC-20 token risk), company contacts and web-to-RAG for AI agents. Pay per call with x402 (USDC on Base). No signup, no API key.","url":"https://freetier-agent-api.pages.dev/api/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","description":"ENS name (label.eth) or Basename (label.base.eth); or pass address instead"},"chain":{"enum":["all","ethereum","base"],"type":"string","description":"reverse lookup chains, default all"},"address":{"type":"string","description":"0x address for reverse lookup (primary name)"},"records":{"type":"string","description":"comma list of text keys (max 8) or \"all\""}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"at":{"type":["string","null"]},"mode":{"type":["string","null"]},"name":{"type":["string","null"]},"node":{"type":["string","null"]},"text":{"type":"object","properties":{"url":{"type":["string","null"]},"email":{"type":["string","null"]},"avatar":{"type":["string","null"]},"com.github":{"type":["string","null"]},"com.discord":{"type":["string","null"]},"com.twitter":{"type":["string","null"]},"description":{"type":["string","null"]},"org.telegram":{"type":["string","null"]}}},"chain":{"type":["string","null"]},"names":{"type":"array","items":{"type":["object","null"]}},"method":{"type":["string","null"]},"address":{"type":["string","null"]},"sources":{"type":"array","items":{"type":["object","null"]}},"resolver":{"type":["string","null"]},"primary_name":{"type":["string","null"]}}}}}}},"responseSchema":{"type":"json","example":{"mode":"forward","name":"vitalik.eth","text":{"url":"https://vitalik.ca","com.twitter":"VitalikButerin"},"chain":"ethereum","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","resolver":"0x231b0ee14048e9dccd1d247744d114a4eb5e8e63"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hcKEaq0TXxAT7o_1lvVbc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves ENS names and Basenames to Ethereum addresses and profile records, or performs reverse lookups from address to primary name, via pay-per-call x402 USDC micropayment.","exampleAgentPrompt":"What Ethereum address does vitalik.eth resolve to, and can you also grab the Twitter handle and URL from its ENS profile?","exampleUseCases":[{"title":"ENS name to address resolution","prompt":"I have the ENS name 'vitalik.eth' — can you resolve it to its Ethereum address and pull any social links like Twitter or GitHub from the profile?"},{"title":"Reverse lookup wallet to primary name","prompt":"Given the wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, what is its ENS primary name?"},{"title":"Basename profile enrichment","prompt":"Look up myusername.base.eth on the Base chain and return all its text records including email, avatar, and description."}],"resultDescription":"Returns a JSON object with the resolution mode (forward or reverse), the resolved ENS/Basename name, the linked Ethereum address, the ENS node hash, the resolver contract address, the chain it was found on, and a map of text records (url, email, avatar, com.twitter, com.github, com.discord, org.telegram, description). For reverse lookups, includes the primary_name and a list of names associated with the address.","failureModes":["Name not found or not registered — returns null fields","Invalid ENS/Basename format — returns error","Address not associated with any primary name — primary_name is null","Text records not set — text fields return null","Payment failure via x402 — 402 response requiring USDC on Base","Rate limit or network error from ENS resolver — 5xx response"],"whenToPreferThis":"Use this endpoint when you need on-demand ENS or Basename resolution without an API key or subscription — ideal for AI agents paying per-call via x402 USDC micropayments on Base. Prefer this over self-hosted ENS resolution when you lack RPC infrastructure, or over general Web3 APIs when you want a lightweight REST interface that also returns rich profile text records in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:03:54.055Z","isFirstParty":false,"canonicalSlug":"ens-basename-lookup-api-x402-6c055d3c"}