{"uid":"cap_NQzDah3GiIRvufSFdXLxo","slug":"token-contract-inspector-base-ethereum-optimism-arbitrum-polygon-289ade09","name":"Token Contract Inspector (Base/Ethereum/Optimism/Arbitrum/Polygon)","description":"Pay-per-call utilities for AI agents over x402, USDC on Base.","url":"https://agents.crowdspark.me/v1/chain/token?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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","optimism","arbitrum","polygon"],"type":"string","description":"Chain, default base"},"address":{"type":"string","description":"Token contract address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","chain":"base","owner":"0x3ABd6f64A422225E61E435baE41db12096106df7","proxy":{"type":"zeppelinos (legacy unstructured storage)","admin":"0x4fc7850364958d97B4d3f5A08f79db2493f8cA44","is_proxy":true,"implementation":"0x2Ce6311ddAE708829bc0784C967b7d77D19FD779"},"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chain_id":8453,"decimals":6,"standard":"ERC20","is_contract":true,"total_supply":"4299464528.64453"}},"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_IdTVzM3y9JVpUvIWe5KRa","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":"Inspects a token contract address on Base, Ethereum, Optimism, Arbitrum, or Polygon to detect contract type (ERC20/ERC721/ERC1155), name, symbol, decimals, total supply, owner, and upgradeable-proxy details.","exampleAgentPrompt":"Before we proceed with the swap, can you inspect the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base and tell me if it's a real ERC20, how many decimals it has, and whether it's an upgradeable proxy?","exampleUseCases":[{"title":"Pre-swap token safety check","prompt":"I'm about to swap into 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — can you verify it's a legitimate ERC20, tell me its name and symbol, total supply, and whether it's a proxy contract before I proceed?"},{"title":"NFT contract type detection","prompt":"Can you check the contract at 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum and tell me if it's an ERC721 or ERC1155, who owns it, and if it has any upgradeable proxy setup?"},{"title":"DeFi listing due diligence","prompt":"We're about to list 0x4200000000000000000000000000000000000042 on Optimism in our app — can you pull its token metadata, confirm its standard, decimals, and check if it's behind an upgradeable proxy so we know the risk?"}],"resultDescription":"Returns a JSON object with: token name, symbol, decimals, total supply (raw and formatted), token standard (ERC20/ERC721/ERC1155), whether the address is a contract, contract owner address, chain and chain_id, and a proxy object indicating whether it's an upgradeable proxy (with type such as EIP-1967, beacon, EIP-1167 clone, or legacy zeppelinos), plus implementation and admin addresses if applicable.","failureModes":["Address is not a contract (EOA) — is_contract returns false","Unsupported chain specified — returns error or defaults to base","Invalid or malformed address (not 0x... format) — returns validation error","RPC timeout or public node unavailability — may return upstream network error","Contract exists but implements no recognized standard — standard field may be null or undetected","Rate limit exceeded without payment — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need on-chain ground-truth metadata about a token contract — especially before executing swaps, payments, or listings — and need to know the token standard, proxy upgrade risk, owner, supply, and decimals in a single call. Prefer this over generic block explorers when you need structured, machine-readable output directly consumable by an agent, and when operating across Base, Ethereum, Optimism, Arbitrum, or Polygon.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:15.525Z","isFirstParty":false,"canonicalSlug":"token-contract-inspector-base-ethereum-optimism-arbitrum-polygon-289ade09"}