{"uid":"cap_yfHynrEhNFo5FVsnz8iKM","slug":"ens-basename-resolver-x402-b2013f49","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/api/chain/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","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_WWGvfw9O4Ni3Fhw6FzXJ7","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 ENS names or Basenames to Ethereum addresses (and vice versa), returning verified forward/reverse records, on-chain metadata, and safe-to-send status — paid per-call via x402 USDC.","exampleAgentPrompt":"Can you resolve vitalik.eth to its Ethereum address and confirm the forward and reverse records match so it's safe to send funds to?","exampleUseCases":[{"title":"Safe send verification before transfer","prompt":"Before I send 1 ETH, resolve jesse.base.eth to an address and tell me whether the forward and reverse ENS records are verified and it's safe to send to."},{"title":"Reverse lookup for unknown wallet","prompt":"I have the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — can you tell me its ENS name and any associated profile info like avatar or website?"},{"title":"Preflight check before airdrop","prompt":"I'm about to send tokens to vitalik.eth — look it up, confirm the resolved address, check whether it's a contract or a regular wallet, and flag any issues."}],"resultDescription":"Returns a JSON object containing the resolved address, ENS/Basename name, forward and reverse records (avatar, URL), a boolean safe_to_send flag, verification status, direction of resolution, whether it is a Basename, a contract check (including EIP-7702 delegation), a summary string, and suggested next API calls for wallet snapshots or contract info.","failureModes":["ENS name not found or not registered — returns error or empty result","Address has no reverse ENS record — reverse_name field may be null","Forward/reverse mismatch — verified flag is false, safe_to_send may be false","Invalid address format — rejected by pattern validation","Network latency resolving ENS records from chain — slow or timeout","Payment failure via x402 — call rejected before data is returned"],"whenToPreferThis":"Use this endpoint when an AI agent needs to resolve human-readable ENS or Basename identities to Ethereum addresses (or vice versa) before executing onchain actions like transfers, contract calls, or wallet lookups. It is particularly valuable when you need bidirectional verification and a safe-to-send flag to avoid sending funds to unverified or contract addresses. Prefer this over generic RPC calls when you need enriched records (avatar, URL), contract checks, and EIP-7702 delegation status bundled in one call with no API key required — just pay $0.002 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:20.483Z","isFirstParty":false,"canonicalSlug":"ens-basename-resolver-x402-b2013f49"}