{"uid":"cap_0CtRF0ulA7LkVruk-_AdM","slug":"ens-basename-lookup-verification-91e723dc","name":"ENS / Basename Lookup & Verification","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/crypto/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_RzyijUp3MSc9oZb5pVziJ","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 its Ethereum address (and vice versa), verifying forward/reverse match and checking if it is safe to send funds to.","exampleAgentPrompt":"Can you resolve vitalik.eth to its Ethereum address and confirm the forward and reverse records match before I send anything to it?","exampleUseCases":[{"title":"Safe send verification before transfer","prompt":"Before I send 0.5 ETH, resolve jesse.base.eth to its Ethereum address and tell me if the forward and reverse records are verified and it's safe to send to."},{"title":"Reverse lookup for wallet identity","prompt":"I have the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — can you do a reverse ENS lookup and tell me what name it belongs to, and whether there's an avatar or URL attached?"},{"title":"Pre-trade counterparty identity check","prompt":"We're about to pay out to the ENS name trader42.eth — resolve it to an address, confirm the records match, and let me know if it's a contract or a regular wallet."}],"resultDescription":"Returns the resolved Ethereum address, the ENS/Basename name, direction of resolution (forward or reverse), whether the forward and reverse records are verified to match, a safe-to-send boolean, ENS records such as avatar and URL, a contract check on Base (is_contract, EIP-7702 delegation), a human-readable summary, and suggested next API calls for deeper wallet or contract analysis.","failureModes":["Name not found / not registered — returns null or error if ENS name does not exist","Address has no reverse record — reverse lookup returns empty name","Forward/reverse mismatch — verified=false and safe_to_send may be false","Invalid address format — rejected by the address regex pattern","Payment failure — x402 USDC micropayment on Base not completed, request blocked","Network or resolver timeout — upstream ENS resolver unreachable"],"whenToPreferThis":"Choose this endpoint when you need to resolve an ENS name or Basename to an address (or vice versa), verify that both records match before sending funds, or retrieve ENS profile metadata (avatar, URL). It requires no API key and charges $0.002 USDC per call via x402, making it ideal for onchain AI agents that already handle micropayments. Prefer it over general-purpose RPC calls when you also need the safe-to-send flag, contract check, and suggested follow-up endpoints in one response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:07.917Z","isFirstParty":false,"canonicalSlug":"ens-basename-lookup-verification-91e723dc"}