{"uid":"cap_MXnwvNaDR1jZYgaSln_bm","slug":"ethereum-contract-risk-heuristics-569fd637","name":"Ethereum Contract Risk Heuristics","description":"Heuristic risk flags for a Ethereum contract from free public data: Sourcify verification, upgradeable proxy + admin, owner type, mint/pause/blacklist/fee selectors, bytecode size. Not an audit or financial advice.","url":"https://automaton-tx-explainer.vercel.app/v1/ethereum/contract-risk?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":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Ethereum contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_zElFJ4d8DM4JInCO6WfZr","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":"Returns heuristic risk flags for an Ethereum smart contract address using free public data, including Sourcify verification status, proxy/admin detection, owner type, dangerous selectors, and bytecode size.","exampleAgentPrompt":"Can you check the risk flags on the Ethereum contract at 0xdAC17F958D2ee523a2206206994597C13D831ec7 — I want to know if it's Sourcify-verified, whether it's an upgradeable proxy, and if it has any mint, pause, or blacklist functions?","exampleUseCases":[{"title":"DeFi contract safety check before investing","prompt":"Before I interact with this DeFi protocol, can you pull the risk heuristics for the Ethereum contract at 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D? I want to know if it's verified, has admin controls, or any dangerous selectors like mint or blacklist."},{"title":"Token contract scam detection","prompt":"I found this token contract on Ethereum at 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE — can you check if it has pause or blacklist functions that the owner could use to rug pull?"},{"title":"Proxy upgrade risk assessment","prompt":"Is the Ethereum contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 an upgradeable proxy? Check if there's an admin address that could change the implementation and flag any other risk indicators."}],"resultDescription":"Returns a structured set of heuristic risk flags for the given Ethereum contract address, including: whether the contract is verified on Sourcify, whether it implements an upgradeable proxy pattern with an admin address, the type of contract owner (EOA, multisig, etc.), presence of dangerous function selectors (mint, pause, blacklist, fee), and the compiled bytecode size. Results are heuristic indicators only, not a full security audit.","failureModes":["Invalid or non-checksummed Ethereum address returns a 400 error","Address is an EOA (externally owned account), not a contract — may return empty or minimal results","Contract not indexed or very new — Sourcify verification may be unavailable","Rate limiting or upstream public RPC unavailability causing 5xx errors","Bytecode may be identical to a known contract but unverified, leading to incomplete flags"],"whenToPreferThis":"Choose this endpoint when you need a quick, low-cost ($0.01) heuristic risk snapshot of a specific Ethereum mainnet contract using only free public data — ideal for pre-interaction safety checks in DeFi agents, wallet UX warnings, or automated contract screening pipelines. Prefer it over a full audit service when speed and cost matter more than exhaustive analysis, or when you need machine-readable risk flags rather than a narrative report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:36:41.715Z","isFirstParty":false,"canonicalSlug":"ethereum-contract-risk-heuristics-569fd637"}