{"uid":"cap_fNpd1i2_IBY54HKVQWGaw","slug":"ens-bidirectional-resolver-7549c73c","name":"ENS Bidirectional Resolver","description":"","url":"https://agent-commerce-factory-jm.austriaeast.cloudapp.azure.com/v1/onchain/ens","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":[],"properties":{"name":{"type":"string","maxLength":255,"minLength":3,"description":"ENS name to resolve to an address (e.g. vitalik.eth)."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address to reverse-resolve to its primary ENS name."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["machine","route","result"],"properties":{"route":{"type":"string"},"result":{"type":"object","properties":{"name":{"type":["string","null"]},"query":{"type":["string","null"]},"address":{"type":["string","null"]}}},"machine":{"type":"string"},"economics":{"type":"object","properties":{"sellPriceUsd":{"type":"number"},"upstreamCostUsdActual":{"type":["number","null"]}}}}}}}}},"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_4xZ1BQLKPHgfPv1QeXt8P","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 to Ethereum addresses (forward) and Ethereum addresses to primary ENS names (reverse), live on Ethereum mainnet.","exampleAgentPrompt":"What Ethereum address does vitalik.eth resolve to on mainnet? Also, can you reverse-lookup 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 and tell me its primary ENS name?","exampleUseCases":[{"title":"Wallet address book ENS display","prompt":"I have a list of Ethereum addresses in my app's contact book — can you look up the primary ENS name for 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B so I can show a human-readable name instead of the raw address?"},{"title":"ENS name to address resolution","prompt":"I want to send ETH to nick.eth — can you resolve that ENS name to the actual Ethereum wallet address so I know where the funds will go?"},{"title":"Identity verification for DeFi agent","prompt":"Before my agent interacts with this wallet, can you check whether 0x983110309620D911731Ac0932219af06091b6744 has a registered ENS name on Ethereum mainnet so I can verify their on-chain identity?"}],"resultDescription":"Returns a result object containing the queried ENS name or address (query field), the resolved Ethereum address (address field, null if not found), and the resolved ENS name (name field, null if not set). Also includes the route and machine identifiers, plus pricing economics.","failureModes":["ENS name has no address record — address field returns null","Ethereum address has no primary ENS name set — name field returns null","Invalid ENS name format (too short or malformed) — validation error","Invalid Ethereum address format (not matching 0x hex pattern) — schema validation rejection","Neither name nor address provided in body — required field error","Network or RPC latency spike causing slow or failed on-chain resolution"],"whenToPreferThis":"Choose this endpoint when you need live, authoritative ENS resolution directly from Ethereum mainnet — both forward (ENS → address) and reverse (address → ENS name) in a single API. Prefer it over cached or third-party ENS lookup services when accuracy and freshness matter, such as before executing a transaction or displaying verified identity. Ideal for wallet UX, address books, identity agents, and DeFi workflows where stale data could cause errors.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:29.342Z","isFirstParty":false}