{"uid":"cap_2hPuXuG4vYasRsI15AqG3","slug":"x402-base-tools-basename-resolver-b23b3e14","name":"x402 Base Tools – Basename Resolver","description":"Resolve a Basename (name.base.eth) to its address, or find the primary Basename of an address (only when the name points back to it).","url":"https://base.kagurazaka.dev/v1/basename?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","description":"a Basename such as jesse.base.eth (or jesse)"},"address":{"type":"string","description":"an address, to find its Basename"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{},"address":{}}}}}}},"responseSchema":{"type":"json","example":{"name":"jesse.base.eth","address":"0x2211d1d0020daea8039e46cf1367962070d77da9"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O2prdy_1bleSP2M90RWgH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Basename (e.g. jesse.base.eth) to its Ethereum address, or reverse-resolves an address to its primary Basename on Base.","exampleAgentPrompt":"What's the wallet address for jesse.base.eth on Base? I need to resolve that Basename to an actual address.","exampleUseCases":[{"title":"Resolve Basename before sending payment","prompt":"Before I send USDC, can you look up the wallet address for vitalik.base.eth so I know I have the right destination?"},{"title":"Identify Basename of a known wallet","prompt":"I have this address 0x2211d1d0020daea8039e46cf1367962070d77da9 — does it have a Basename registered on Base?"},{"title":"Verify identity behind a Basename","prompt":"Someone told me their Basename is alice.base.eth — can you confirm what Ethereum address that resolves to so I can verify it's the right person?"}],"resultDescription":"Returns a JSON object containing the resolved Basename (e.g. 'jesse.base.eth') and its corresponding Ethereum address (e.g. '0x2211...'). For forward resolution (name → address), returns the address. For reverse resolution (address → name), returns the primary Basename only if the name points back to that address (verified reverse lookup).","failureModes":["Name not registered: returns null or empty address if the Basename does not exist","Reverse resolution fails: address has no primary Basename set, or the name does not point back to the address","Invalid input: malformed address or name format returns an error","Network issues: Base RPC unavailability may cause timeouts","Name mismatch: reverse resolution returns nothing if primary name does not point back to the queried address"],"whenToPreferThis":"Use this endpoint when you need to resolve a Base-native .base.eth Basename to an Ethereum address or vice versa, specifically on the Base L2 network. Prefer this over generic ENS resolvers when working within the Base ecosystem, as it handles Basename-specific reverse resolution validation (name-to-address pointer check). Ideal for identity enrichment, payment address verification, or user display name lookups in Base-native dApps and agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:34.745Z","isFirstParty":false,"canonicalSlug":"x402-base-tools-basename-resolver-b23b3e14"}