{"uid":"cap_3SbUDdKhaDWe6sR_Q-OA5","slug":"xerxes-base-address-object-lookup-de9e5d50","name":"Xerxes Base Address Object Lookup","description":"Use when an agent needs to know what a Base address is at a known block: EOA, ERC-20, Uniswap V2/V3 pool, bare contract, or unread. Returns a typed object plus blockNumber and blockHash. A token that is not a pool is a token. Dead RPC is unreadability, not zeros.","url":"https://ari001.tailb4ac3a.ts.net/v1/base/object/:addr","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"},"pathParams":{"type":"object","required":["addr"],"properties":{"addr":{"type":"string","description":"20-byte 0x address on Base"}}},"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.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rCSDdJyzD78t2Ou_Jn3Fl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 address to a typed object (EOA, ERC-20 token, Uniswap V2/V3 pool, bare contract, or unreadable) along with the block number and block hash at which it was classified.","exampleAgentPrompt":"What kind of address is 0x4200000000000000000000000000000000000006 on Base — is it a wallet, a token contract, or a Uniswap pool?","exampleUseCases":[{"title":"Identify unknown Base address type","prompt":"I've got this address 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base — can you tell me whether it's an EOA, an ERC-20 token, a Uniswap pool, or just a bare contract?"},{"title":"Verify token before DeFi interaction","prompt":"Before I swap into it, check whether 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base is actually an ERC-20 token and not a pool or some random contract."},{"title":"Detect Uniswap pool address on Base","prompt":"Is the contract at 0x4C36388bE6F416A29C8d8Eee81C771cE6bE14B18 on Base a Uniswap V2 or V3 liquidity pool? I need to know so I can fetch its reserves correctly."}],"resultDescription":"Returns a typed object indicating the address classification (EOA, ERC-20, Uniswap V2 pool, Uniswap V3 pool, bare contract, or unreadable), along with the blockNumber and blockHash at which the classification was made. If the RPC is unreachable the address is marked unreadable rather than returning zeros.","failureModes":["Invalid or malformed address (not a 20-byte 0x hex string) — likely 4xx validation error","RPC node unavailable — address returned as 'unreadable' type rather than zeros","Address exists but is a bare contract with no recognized ABI — returned as bare contract type","Network timeout or infrastructure error — 5xx response"],"whenToPreferThis":"Use this endpoint when you need to definitively classify a Base network address into a known on-chain type (EOA, ERC-20, Uniswap V2/V3 pool, bare contract, or unreadable) at a specific block. It is more specific than a generic balance or ABI lookup because it returns a typed object rather than raw data, and it explicitly distinguishes pools from tokens and unreachable nodes from zero-value addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:39:10.624Z","isFirstParty":false}