{"uid":"cap_rNNL0Xfy3-syTp5luQylg","slug":"scan-madhousewallet-com-17a11261","name":"Madhouse Wallet Optimism Address Risk Scanner","description":"Returns public scan data for the Optimism network.","url":"https://scan.madhousewallet.com/api/public/scan/optimism","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"EVM wallet address (0x-prefixed, checksummed) or ENS name to scan."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","toxicScore","riskLevel","shouldFlag","flaggedMetrics"],"properties":{"ens":{"type":["string","null"],"description":"Resolved ENS name if the address has one, otherwise null."},"address":{"type":"string","description":"The queried wallet address (checksummed or ENS-resolved)."},"riskLevel":{"enum":["PASS","LOW","MIDDLE","CRITICAL"],"type":"string","description":"PASS = score 0; LOW = 0-0.40; MIDDLE = 0.41-0.80; CRITICAL >= 0.81."},"isContract":{"type":"boolean","description":"True if the address is a smart contract, not an EOA."},"shouldFlag":{"type":"boolean","description":"True if toxicScore > 0. Off-ramp compliance rule: only exact score 0 passes; any non-zero score must be flagged."},"toxicScore":{"type":"number","description":"Normalized risk score from 0 (clean) to 1 (critical). NOTE: the API may return scores as integers 0-100 for confirmed bad actors; always normalize with score > 1 ? score / 100 : score."},"addressExists":{"type":"boolean","description":"True if the address has any on-chain transaction history."},"flaggedMetrics":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Risk category name. Known values: known_scammer, sanction_address, blacklist, initiator_scam_transactions, suspicious_dex_pair_deployer, suspicious_deployer, attack_money_target, zero_address_risk, rug_pull, rug_pull_trader, sanction_address_communication, fake_phishing_contract_communication, fake_phishing_transfer, mixer_transfers, non_kyc_transfers."},"risk":{"type":"number","description":"Risk contribution. >0 means flagged."},"type":{"enum":["absolute","volume"],"type":"string","description":"absolute = binary yes/no flag. volume = scaled by USD transaction volume."},"txsCount":{"type":"number","description":"Number of flagged transactions (volume metrics only)."},"description":{"type":"string"},"incomingMoneyUSD":{"type":"number","description":"Flagged incoming USD (volume metrics only)."},"outgoingMoneyUSD":{"type":"number","description":"Flagged outgoing USD (volume metrics only)."}}},"description":"Risk signals that contributed to the score. Empty array means all 15 risk categories are clean."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"unknown","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_KNk5mTy5rZcojsn47p2Y1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scans an Optimism network wallet address or ENS name for on-chain risk signals, returning a normalized toxicity score, risk level, and flagged risk metrics.","exampleAgentPrompt":"Can you check whether the Optimism wallet address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e is safe to send funds to — give me its risk level and any flagged risk categories?","exampleUseCases":[{"title":"Verify wallet safety before DeFi transfer","prompt":"I'm about to send my USDC to this Optimism address: 0x8ba1f109551bD432803012645Ac136ddd64DBA72. Can you run a quick security scan and let me know if it's flagged for any scams or suspicious activity?"},{"title":"Screen counterparty for compliance requirements","prompt":"Our team needs to process a withdrawal request from vitalik.eth on Optimism. Can you check if this address has any sanctions flags or known fraud patterns that would block the transaction?"},{"title":"Detect potential rug pull risks in protocol","prompt":"I'm looking to invest in a new token launched on Optimism, and the dev team's wallet is 0x1234567890abcdef1234567890abcdef12345678. Can you scan whether this address has any history of rug pulls or scammer flags?"}],"resultDescription":"Returns a JSON object with the queried wallet address, a normalized toxicity score (0=clean, 1=critical), a risk level enum (PASS, LOW, MIDDLE, CRITICAL), a shouldFlag boolean, a list of flagged risk metric objects (e.g. known_scammer, sanction_address, rug_pull), whether the address is a contract, whether it has on-chain history, and the resolved ENS name if applicable.","failureModes":["Invalid or malformed wallet address returns an error","ENS name that cannot be resolved returns an error or null address","Address with no on-chain history returns addressExists=false with minimal risk data","Network timeout or upstream provider unavailability returns a 5xx error","Unpaid or insufficient USDC balance causes a 402 payment required response"],"whenToPreferThis":"Use this endpoint specifically when you need to assess risk for addresses on the Optimism (OP Mainnet) network. It is backed by Web3 Antivirus data and returns a structured toxicity score, risk tier, and categorized flag reasons. Prefer this over generic blockchain explorers when compliance screening, off-ramp flagging, or fraud detection logic is needed for Optimism addresses specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:48.898Z","isFirstParty":false}