{"uid":"cap_5SKAwm0bcHJPzh--Qt15N","slug":"blockscout-contract-inspector-x402-777b91c9","name":"Blockscout Contract Inspector (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/blockscout/contract?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","eth"],"type":"string","description":"base (default) or eth mainnet"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"Address to inspect"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"kind":"ERC20","next":["/crypto/token-risk?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","/crypto/allowance?owner=&spender="],"safe":null,"chain":"base","flags":["upgradeable_proxy","has_owner","admin_can_change_logic"],"owner":"0x...","proxy":{"type":"ZEPPELINOS_LEGACY","admin":"0x4fc7850364958d97b4d3f5a08f79db2493f8ca44","beacon":null,"is_proxy":true,"implementation":"0x2ce6311ddae708829bc0784c967b7d77d19fd779"},"token":{"name":"USD Coin","symbol":"USDC","decimals":6,"total_supply":4100000000},"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","summary":"ERC20 USDC behind ZEPPELINOS_LEGACY proxy, has owner","chain_id":8453,"checked_at":"2026-10-30T03:40:00Z","interfaces":{"erc165":false,"erc721":false,"erc1155":false},"is_contract":true,"native_balance":0,"code_size_bytes":1852,"owner_renounced":false}},"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_QN6xnY12j31HyLa_vYJEO","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":"Returns on-chain contract metadata for a given EVM address on Base or Ethereum, including token info, proxy type, ownership, risk flags, and interface compliance.","exampleAgentPrompt":"Look up the contract details for 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know if it's a proxy, who owns it, any risk flags, and the token symbol and decimals.","exampleUseCases":[{"title":"Pre-trade token risk check","prompt":"Before I swap into this token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, check whether it's an upgradeable proxy, whether ownership has been renounced, and what risk flags exist on the contract."},{"title":"Identify unknown contract address","prompt":"I found this address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet — can you tell me what kind of contract it is, whether it's a token, and who controls it?"},{"title":"DeFi agent contract validation","prompt":"Before my agent approves a token spend to 0x4fc7850364958d97b4d3f5a08f79db2493f8ca44 on Base, verify that it's a real contract, check its proxy type, and list any admin control or upgradeability flags."}],"resultDescription":"A JSON object containing the contract's kind (e.g. ERC20), token metadata (name, symbol, decimals, total supply), proxy details (type, admin, implementation), ownership info, boolean risk flags (e.g. upgradeable_proxy, has_owner, admin_can_change_logic), interface compliance (ERC165/721/1155), native balance, code size, chain ID, and suggested follow-up API paths for deeper analysis.","failureModes":["Invalid or non-checksummed address returns a 400 error","Address is an EOA (not a contract) — is_contract will be false with minimal data","Unsupported chain value returns validation error","Network timeout or worker error returns 5xx","Contract not indexed by Blockscout returns empty or partial response","Payment failure (x402) if USDC balance insufficient"],"whenToPreferThis":"Use this endpoint when an AI agent needs to classify and risk-assess an EVM contract address before interacting with it — especially useful for checking proxy upgradeability, admin control risks, and token metadata on Base or Ethereum mainnet. Prefer this over generic block explorers when you need structured JSON output with risk flags and follow-up endpoint suggestions, and when you are operating without a traditional API key (x402 micropayment via USDC on Base). Not suited for transaction history, event logs, or non-EVM chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:21.908Z","isFirstParty":false,"canonicalSlug":"blockscout-contract-inspector-x402-777b91c9"}