{"uid":"cap_ayE6GFIHzbYUcVvKrkit5","slug":"base-reads-basename-resolver-e4413603","name":"Base Reads – Basename Resolver","description":"Pay-per-call read API for Base over x402 v2. Deterministic data, no advice.","url":"https://base-reads-api.rafliyaputra.deno.net/base/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Basename to resolve, with or without the .base.eth suffix (give name or address)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Base address whose verified primary Basename to look up (give name or address)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"jesse.base.eth","address":"0x2211d1d0020daea8039e46cf1367962070d77da9","resolver":"0xc6d566a56a1aff6508b41f6c90ff131615583bcd"}},"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_AQOBx3zgLKAXQo4vA8CIL","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 a .base.eth Basename to its associated address and resolver, or looks up a wallet address's verified primary Basename.","exampleAgentPrompt":"What wallet address does jesse.base.eth resolve to, and which resolver contract handles it?","exampleUseCases":[{"title":"Resolve Basename before sending payment","prompt":"Before I send crypto, can you look up what wallet address coinbase.base.eth resolves to so I know I'm sending to the right place?"},{"title":"Find Basename for a wallet address","prompt":"I have the wallet address 0x2211d1d0020daea8039e46cf1367962070d77da9 — can you tell me what Basename is registered to it?"},{"title":"Verify identity of a Base user","prompt":"Someone told me their Basename is vitalik.base.eth — can you confirm what address it points to so I can verify they are who they say they are?"}],"resultDescription":"Returns a JSON object containing the resolved Basename (e.g. 'jesse.base.eth'), the corresponding wallet address (checksummed 0x format), and the ENS-compatible resolver contract address handling the name.","failureModes":["Name not found: Basename does not exist or has not been registered — empty or null response","Address has no primary Basename: wallet address exists on Base but has no verified primary Basename set","Invalid address format: address parameter does not match ^0x[0-9a-fA-F]{40}$ pattern — schema validation error","Neither name nor address provided: both optional query params omitted — likely 400 or empty response","Payment failure: x402 payment of $0.003 USDC not completed — 402 response returned before data","Network/RPC error: Base node temporarily unavailable — 5xx response"],"whenToPreferThis":"Choose this endpoint when you need on-chain, deterministic resolution of Base (Coinbase L2) Basenames — either forward lookup (name → address) or reverse lookup (address → name). Prefer this over generic ENS resolvers when the name uses the .base.eth suffix and is registered on the Base L2 Basename registry specifically. Ideal for agents that need to verify wallet identities, enrich transaction data with human-readable names, or confirm ownership before executing payments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:43:11.126Z","isFirstParty":false,"canonicalSlug":"base-reads-basename-resolver-e4413603"}