{"uid":"cap_aogn5yyjiySo08cfKji_I","slug":"agenttoll-basename-lookup-bidirectional-a5238b3b","name":"AgentToll Basename Lookup (Bidirectional)","description":"Basename lookup both ways: a name returns its address and text records, an address returns its primary basename","url":"https://agenttoll.app/api/base/name/:nameOrAddress","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"},"pathParams":{"type":"object","required":["nameOrAddress"],"properties":{"nameOrAddress":{"type":"string","description":"A basename (.base.eth optional) or a 0x address"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_XgtHnvOUXIy-VA1-ei4wp","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 Base blockchain name (.base.eth) to its address and text records, or resolves a 0x address to its primary basename","exampleAgentPrompt":"What wallet address does alice.base.eth resolve to, and do they have any text records on their basename?","exampleUseCases":[{"title":"Resolve basename to wallet address","prompt":"I need to send some ETH to bob.base.eth — can you look up the actual 0x wallet address that basename points to?"},{"title":"Reverse-lookup address to basename","prompt":"What is the primary Base name registered to the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?"},{"title":"Fetch identity profile from basename","prompt":"Can you pull up all the text records and profile info attached to the basename satoshi.base.eth?"}],"resultDescription":"For a name input: returns the resolved 0x wallet address and any associated text records (e.g. avatar, description, social handles). For an address input: returns the primary registered basename associated with that address.","failureModes":["Name not registered or does not exist — empty or null result","Address has no primary basename set — returns null basename field","Malformed input (invalid basename format or non-checksummed address) — likely 400 error","Network or RPC resolution failure — 500 or timeout","Rate limiting at $0.001/call threshold exceeded — payment or 402 error"],"whenToPreferThis":"Use this endpoint when you need bidirectional Base blockchain name resolution — either forward (basename → address + text records) or reverse (address → primary basename). Prefer it over generic ENS resolvers when working specifically with Base-native identities, or when you also need text records alongside the address. It is the simplest single-call solution for Base name ↔ address lookups without setting up your own RPC node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:43:37.692Z","isFirstParty":false}