{"uid":"cap_SWYw2FAbmIB0qj3MyXM9Y","slug":"xerxes-base-object-lookup-7c27bc86","name":"Xerxes Base Object Lookup","description":"ARYSPHERE Base typed objects and transaction proofs behind x402. Dead RPC is unreadability, not zeros.","url":"https://ari001.tailb4ac3a.ts.net/v1/base/object/%7Baddr%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"ok":true,"kind":"erc20","pool":null,"proof":{"block_hash":"0xabababababababababababababababababababababababababababababababab","block_number":12345678},"token":{"name":"USD Coin","symbol":"USDC","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6,"total_supply":"1000"},"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","service":"base_object","balance_wei":null,"usdc_atomic":null,"bytecode_bytes":1200}},"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_FWksq6PJVe4MXw32j-WuF","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 its typed object kind (EOA, ERC-20, Uniswap pool, etc.) along with token metadata, bytecode size, and transaction proof anchors.","exampleAgentPrompt":"What kind of object is the Base address 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 — is it an ERC-20 token or something else, and if so what are its token name, symbol, decimals, and the block proof confirming it exists?","exampleUseCases":[{"title":"Identify unknown Base contract type","prompt":"I found this Base address 0x1111111111111111111111111111111111111111 in a transaction — can you tell me whether it's a plain wallet, an ERC-20 token, or a Uniswap pool, and give me any token details if it has them?"},{"title":"Fetch ERC-20 token metadata for DeFi app","prompt":"I need the token name, symbol, decimals, and total supply for the USDC contract on Base at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 — also include the block proof so I can verify when it was confirmed."},{"title":"Audit smart contract bytecode presence","prompt":"Check the Base address 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA and tell me whether it has bytecode deployed and how large it is — I want to confirm it's actually a live contract and not an empty address."}],"resultDescription":"Returns a JSON object with: `ok` (success flag), `kind` (string — 'eoa', 'erc20', 'uniswap_v2', 'uniswap_v3', etc.), `address`, `token` (name, symbol, address, decimals, total_supply — present for ERC-20s), `pool` (pool metadata if applicable), `proof` (block_hash and block_number anchoring the object's existence on-chain), `bytecode_bytes` (size of deployed bytecode), `balance_wei`, and `usdc_atomic`. The `service` field echoes `base_object`.","failureModes":["Invalid or malformed address returns an error or ok:false","Address not found on Base mainnet (wrong chain) returns null or empty kind","RPC node unavailability causes timeout or 5xx","Non-checksummed address may fail validation","Rate limiting or payment verification failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need to classify a Base address by type and retrieve rich metadata in a single call — especially when you need both the object kind (EOA vs ERC-20 vs Uniswap pool) and a cryptographic block proof in one response. Prefer this over raw RPC calls when you want typed, structured output without parsing raw eth_getCode or eth_call yourself. Best suited for agents that need on-chain object classification on Base L2 specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:24.130Z","isFirstParty":false}