{"uid":"cap_TRZdYTIhchhscSrT5l3dT","slug":"ens-resolution-api-onchain-query-57c2a9ef","name":"ENS Resolution API (Onchain Query)","description":"ENS name resolution in both directions on Ethereum mainnet. Pass name to resolve an ENS name to its address (forward), or pass address to get that address's primary ENS name (reverse, forward-verified so spoofed reverse records are rejected). Read straight from the ENS registry. Use it to turn vitalik.eth into an address, or to label a raw address with a human-readable name.","url":"https://chain.cyberwarex.com/ens","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","anyOf":[{"required":["name"]},{"required":["address"]}],"required":[],"properties":{"name":{"type":"string","description":"ENS name to resolve forward, e.g. vitalik.eth."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Address to reverse-resolve to its primary ENS name."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{"type":["string","null"]},"note":{"type":["string","null"],"description":"Set when a reverse record failed forward verification."},"address":{"type":["string","null"]},"resolved":{"type":"boolean"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Uhm14-J-ec3XPmHXW05sQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 lookup) or resolves Ethereum addresses back to their primary ENS name (reverse lookup)","exampleAgentPrompt":"What Ethereum address does vitalik.eth resolve to? Or, flip it around — what ENS name is associated with 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?","exampleUseCases":[{"title":"Forward resolve ENS to address","prompt":"Can you look up the Ethereum address for nick.eth? I need to send funds and want to confirm the exact 0x address it maps to before I do anything."},{"title":"Reverse resolve wallet to ENS name","prompt":"I have this wallet address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B — can you tell me if it has a human-readable ENS name registered?"},{"title":"Verify ENS identity in a dapp","prompt":"Before I display this user's profile, can you confirm that 0x983110309620D911731Ac0932219af06091b6744 has a valid primary ENS name that also forward-resolves correctly back to this address?"}],"resultDescription":"Returns a JSON object with: `resolved` (boolean indicating success), `name` (the primary ENS name if reverse-resolved, or null), `address` (the 0x address if forward-resolved, or null), and an optional `note` field explaining any forward-verification failure for reverse records.","failureModes":["Name not registered — resolved=false, address=null","Address has no primary ENS record set — resolved=false, name=null","Reverse record exists but forward verification fails — resolved=false with a descriptive note","Invalid address format — schema validation rejects input before call","Payment failure — x402 payment of $0.003 USDC not processed, 402 response returned"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, pay-per-call ENS resolution without managing your own Ethereum RPC infrastructure or API keys. Ideal for agents that need to enrich wallet addresses with human-readable names, validate ENS identities, or resolve names to addresses on-the-fly. It covers both forward (name→address) and reverse (address→name) lookups in a single endpoint with deterministic JSON output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:33:39.229Z","isFirstParty":false}