{"uid":"cap_FFLFjDoXSsY6_7sXgmav4","slug":"ens-basename-resolver-x402-27502b6a","name":"ENS / Basename Resolver (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/v1/ens-resolve?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","properties":{"name":{"type":"string","examples":["vitalik.eth","jesse.base.eth"],"maxLength":255,"description":"ENS name or Basename, e.g. vitalik.eth, jesse.base.eth"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"description":"Address for reverse lookup"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"vitalik.eth","next":["/crypto/contract-info?address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045","/crypto/wallet-snapshot?wallet=0xd8da6bf26964af9d7eed9e03e53415d37aa96045"],"input":"vitalik.eth","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","records":{"url":"https://vitalik.ca","avatar":"eip155:1/erc1155:0xb32979486938aa9694bfc898f35dbed459f44424/10063"},"summary":"vitalik.eth -> 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 (reverse matches: verified)","verified":true,"direction":"forward","checked_at":"2026-10-30T05:40:00Z","is_basename":false,"reverse_name":"vitalik.eth","safe_to_send":true,"contract_check":{"chain":"base","is_contract":false,"eip7702_delegated":false}}},"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_yIlhptYHtWezgqirLHUyT","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 or Basename to an Ethereum address (or reverse-looks up a name from an address), returning verified records, reverse-match status, and send-safety checks.","exampleAgentPrompt":"Before I send ETH to vitalik.eth, can you resolve that ENS name to its Ethereum address and confirm the forward and reverse lookups both match so it's safe to send?","exampleUseCases":[{"title":"Pre-send ENS safety check","prompt":"I'm about to send 0.5 ETH to jesse.base.eth — can you resolve that Basename to its actual wallet address and confirm the forward and reverse lookups match before I proceed?"},{"title":"Reverse lookup from wallet address","prompt":"I have the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — can you look up what ENS name is associated with it and tell me if it's verified?"},{"title":"Avatar and profile record fetch","prompt":"Can you resolve vitalik.eth and pull back any profile records like avatar or website URL stored in the ENS name?"}],"resultDescription":"Returns the resolved Ethereum address, direction of lookup (forward or reverse), reverse name, verification status (bidirectional match), safe-to-send flag, any stored records (avatar, URL), whether the address is a contract or EIP-7702 delegated, the chain checked, a human-readable summary, and suggested next API calls for deeper analysis.","failureModes":["ENS name does not exist or has expired — returns null address","Address has no reverse ENS record set — reverse lookup returns empty","Forward and reverse records do not match — verified:false and safe_to_send:false","Invalid address format (not 0x + 40 hex chars) — schema validation error","Name resolution timeout due to ENS provider unavailability","Payment failure via x402 if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when an AI agent needs to resolve ENS names or Basenames to Ethereum addresses (or vice versa) before executing onchain actions like token transfers, contract interactions, or wallet lookups. It is especially valuable when you need bidirectional verification and a safe-to-send flag rather than a raw resolver call. No API key is required — payment is per-call via x402 USDC on Base, making it suitable for autonomous agent pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:04.535Z","isFirstParty":false,"canonicalSlug":"ens-basename-resolver-x402-27502b6a"}