{"uid":"cap_XXlj7YTDGro-OG74jQ--0","slug":"crypto-contract-info-lookup-x402-44f3172b","name":"Crypto Contract Info Lookup (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/crypto/contract-info?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_quLTpyX7dR1T7fDQCubDU","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: token info, proxy structure, admin flags, and risk indicators.","exampleAgentPrompt":"Can you look up the contract info for 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know if it's a proxy, who owns it, and whether there are any admin risk flags?","exampleUseCases":[{"title":"Pre-trade contract safety check","prompt":"Before my agent swaps into this token, check the contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — is it a proxy? Is there an admin who can change the logic? Any risk flags I should know about?"},{"title":"Token metadata retrieval for portfolio display","prompt":"Get me the token name, symbol, decimals, and total supply for the contract 0x4200000000000000000000000000000000000006 on Base so I can display it correctly in my portfolio."},{"title":"Ownership renouncement verification","prompt":"Has the owner of contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base renounced ownership, or does someone still control it?"}],"resultDescription":"A JSON object containing: contract kind (ERC20, EOA, etc.), token metadata (name, symbol, decimals, total supply), proxy details (proxy type, admin address, implementation address), ownership info and whether ownership is renounced, risk flags (e.g. upgradeable_proxy, has_owner, admin_can_change_logic), native ETH balance, code size in bytes, the chain and chain ID, a timestamp, and a 'next' array of suggested sibling endpoint URLs for further analysis.","failureModes":["Invalid address format (not a valid 0x hex address) — schema validation error","Address not found on specified chain — may return is_contract: false with minimal data","Chain param not one of 'base' or 'eth' — rejected by schema enum validation","Payment failure via x402 (insufficient USDC balance on Base) — 402 response with payment details","RPC timeout or node unavailability — upstream error response","Rate limiting or worker capacity issues on Cloudflare edge"],"whenToPreferThis":"Use this endpoint when an AI agent needs to understand the nature and risk profile of an unknown EVM contract address before interacting with it — particularly for pre-trade safety checks, token metadata resolution, or proxy/admin structure analysis. It covers Base and Ethereum mainnet with no API key required, charging $0.002 USDC per call via x402. Prefer this over general blockchain explorers when you need a structured, machine-readable response optimized for agent consumption, with built-in next-step suggestions linking to sibling endpoints like token-risk or allowance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:54.799Z","isFirstParty":false,"canonicalSlug":"crypto-contract-info-lookup-x402-44f3172b"}