{"uid":"cap_3w3B2HMZLkpy8IwegZTkT","slug":"evm-contract-introspection-b16170b1","name":"EVM Contract Introspection","description":"EVM contract introspection — is it a contract, is it a proxy, is it a token — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/evm-contract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism"],"type":"string"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"evm-contract","chain":"base","proxy":{"detected":true,"standard":"zeppelinos","implementation":"0x2ce6…d779"},"token":{"name":"USD Coin","symbol":"USDC","decimals":6,"erc20_like":true,"total_supply":"4285515964.300967"},"receipt":{"tx_hash":"0x<64hex>","amount_usd":0.005,"receipt_id":"g402-<16hex>"},"chain_id":8453,"is_contract":true,"evidence_hash":"sha256:<64hex>","bytecode_bytes":1852}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DAlTZDMGH-8Nd5LJrtIUK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Inspects an EVM contract address to determine if it is a contract, whether it is a proxy, and whether it is a token, returning full metadata.","exampleAgentPrompt":"Can you check if the address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum is a smart contract, whether it's a proxy, and if so what token it represents?","exampleUseCases":[{"title":"Verify token contract before DeFi interaction","prompt":"Before I approve this transaction, can you check whether 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon is actually a real ERC20 token contract and tell me its name, symbol, and decimals?"},{"title":"Identify proxy implementation address","prompt":"I have this contract address on Base — 0x2ce6311ddAE708829bc0784C967b7d77D19BF779 — can you tell me if it's a proxy and what the underlying implementation contract address is?"},{"title":"Audit unknown contract address","prompt":"Someone sent me this address on Arbitrum: 0x912CE59144191C1204E64559FE8253a0e49E6548 — can you tell me if it's a smart contract or just a wallet, and if it's a contract, whether it's a token and what kind?"}],"resultDescription":"Returns a JSON object indicating whether the address is a contract, whether a proxy pattern was detected (including the proxy standard like ZeppelinOS and the implementation address), and if the contract is a token, its name, symbol, decimals, ERC20 compatibility flag, and total supply. Also returns the chain ID, bytecode size, an evidence hash, and a payment receipt.","failureModes":["Address is not a contract (EOA) — is_contract returns false with no token or proxy data","Invalid address format — input validation error if not a valid 0x hex address","Unsupported chain — error if chain is not in the allowed enum","Contract exists but is not a token — token field absent or null","Proxy detection inconclusive — proxy.detected false even if pattern exists but is non-standard","Network timeout or RPC failure — call may return an error or timeout","Insufficient payment — x402 payment not accepted, returns 402"],"whenToPreferThis":"Use this endpoint when you need to quickly classify an unknown EVM address across major chains (Ethereum, Base, Polygon, Arbitrum, Optimism) — especially when you need all three signals (is it a contract, is it a proxy, is it a token) in a single call. Prefer this over manual RPC calls or block explorer scraping when operating in an agentic context where structured, machine-readable output and pay-per-call pricing are preferred. It is especially useful for DeFi due diligence, contract auditing pipelines, or token discovery workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:33:57.681Z","isFirstParty":false,"canonicalSlug":"evm-contract-introspection-b16170b1"}