{"uid":"cap_CxC4K-DtEN6474FnPFuGO","slug":"contract-risk-api-full-check-e0e26150","name":"Contract Risk API – Full Check","description":"Pre-trade safety checks for smart contracts and tokens. All paid routes use the x402 'exact' scheme settling in USDC on Base (eip155:8453). Every 402 carries a signed offer and every 200 a signed receipt (EIP-712) — see /.well-known/x402 -> signing.","url":"https://smartcontractrisk.0xhodhod.xyz/v1/full-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum"],"type":"string","description":"Chain to query (default: base)"},"address":{"type":"string","description":"0x-prefixed EVM contract address to scan"}}},"responseSchema":{"type":"json","example":{"risk":{"flags":[{"label":"upgradeable proxy (EIP-1967) — logic can be swapped by admin","weight":10}],"isProxy":true,"riskLevel":"medium","riskScore":10,"isContract":true},"chain":"base","alerts":{"note":"No mentions in the current rolling window (last 30 messages per tracked channel). Absence of alerts is not a safety guarantee.","channels":[],"categories":{"other":0,"listing":0,"securityAlert":0,"whaleMovement":0},"alertMentions":0},"address":"0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NJ40zkTXv19-GWHkdUyRm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a comprehensive pre-trade safety scan on a smart contract or token address, returning risk scores, proxy/upgrade flags, and on-chain alert signals.","exampleAgentPrompt":"Can you do a full safety check on the contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base before I trade it — I want to know the risk score, whether it's an upgradeable proxy, and if there are any recent security alerts?","exampleUseCases":[{"title":"Pre-trade DeFi token safety check","prompt":"Before I swap into this token, can you scan the contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base and tell me if it's safe — risk score, any proxy shenanigans, and recent alerts?"},{"title":"NFT contract audit before minting","prompt":"I'm about to mint from this Ethereum contract 0x1234567890abcdef1234567890abcdef12345678 — can you run a full risk check and let me know if it's an upgradeable proxy or has any security flags?"},{"title":"Portfolio risk screening for held assets","prompt":"I hold a few tokens on Base — can you check the contract 0xabcdefabcdefabcdefabcdefabcdefabcdef1234 and give me the risk level and any active security alerts from monitored channels?"}],"resultDescription":"Returns a JSON object with a risk block (riskScore integer, riskLevel string, isProxy boolean, isContract boolean, and an array of labeled flags with weights), plus an alerts block showing mention counts across tracked on-chain channels broken down by category (securityAlert, whaleMovement, listing, other) and a note on data window coverage.","failureModes":["Invalid or non-0x-prefixed address returns a validation error","Address not found on the specified chain returns isContract: false with no flags","Unsupported chain value returns a 422 or enum validation error","Payment not settled via x402 USDC on Base returns HTTP 402 with a signed offer","Network timeout or RPC unavailability on Base/Ethereum may cause delayed or failed responses"],"whenToPreferThis":"Choose this endpoint when you need a structured, multi-dimensional pre-trade risk score for a specific EVM contract before executing a DeFi trade or token purchase. It combines on-chain code analysis (proxy detection, upgrade patterns) with real-time social/alert monitoring in a single call. Prefer it over manual block explorer review or generic audit tools when you need machine-readable risk output for automated trading pipelines or agent-driven portfolio decisions on Base or Ethereum.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T20:44:59.441Z","isFirstParty":false,"canonicalSlug":"contract-risk-api-full-check-e0e26150"}