{"uid":"cap_0cyJnNotvpPP3uePL1ZN1","slug":"base-basename-resolver-api-a2bf5db6","name":"Base Basename Resolver API","description":"Resolve a Basename to an address or an address to its primary Basename","url":"https://base-facts.yankii.fr/v1/basename?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"Basename to resolve to an address, e.g. jesse.base.eth"},"address":{"type":"string","description":"Address whose primary Basename to look up (verified by forward resolution)"}}},"responseSchema":{"type":"json","example":{"name":"jesse.base.eth","source":"base-mainnet-rpc","address":"0x2211d1D0020DAEA8039E46Cf1367962070d77DA9","resolver":"0xC6d566A56A1aFf6508b41f6c90ff131615583BCD","blockNumber":"52131900"}},"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_vtOCMutajuba-mDihhWHi","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 a Base blockchain Basename (e.g. jesse.base.eth) to its on-chain address, or looks up the primary Basename for a given address, using live Base mainnet RPC data.","exampleAgentPrompt":"Can you resolve jesse.base.eth to its actual on-chain Ethereum address using the Base blockchain?","exampleUseCases":[{"title":"Resolve Basename before sending crypto","prompt":"I want to send ETH to vitalik.base.eth — can you look up what Ethereum address that Basename resolves to on Base so I know it's correct before I send?"},{"title":"Reverse lookup wallet identity","prompt":"I have the address 0x2211d1D0020DAEA8039E46Cf1367962070d77DA9 — can you check if this wallet has a primary Basename registered on Base?"},{"title":"Verify Basename for onboarding","prompt":"A user says their Base identity is alice.base.eth — can you verify that name and get the on-chain address it resolves to so I can confirm it matches their wallet?"}],"resultDescription":"Returns a JSON object containing the resolved Basename, the on-chain Ethereum address it maps to, the resolver contract address, the block number at which the data was fetched, and the RPC source used (e.g. base-mainnet-rpc).","failureModes":["Name not found: Basename is not registered or does not resolve to any address","Address has no primary Basename registered, returning null name","Invalid input: neither a valid .base.eth name nor a valid Ethereum address provided","RPC timeout or Base node unavailability causing failed resolution","Forward-resolution mismatch: address provided does not verify back to the claimed Basename"],"whenToPreferThis":"Use this endpoint when you need real-time, on-chain resolution of Base Basenames (.base.eth) to Ethereum addresses or vice versa, especially when accuracy matters (it performs forward-resolution verification). Prefer this over ENS mainnet resolvers when dealing specifically with Base L2 identities, and over cached/off-chain lookup services when freshness is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:40:30.312Z","isFirstParty":false,"canonicalSlug":"base-basename-resolver-api-a2bf5db6"}