{"uid":"cap_efwzSXaAh48TILMs6MKty","slug":"vulnhunt-smart-contract-security-snapshot-api-5ea3fec5","name":"VulnHunt Smart Contract Security Snapshot API","description":"Read-only historical smart-contract security intelligence for autonomous agents.","url":"https://vulnhunt-agent-api-production.up.railway.app/v1/contracts/%7Bchain_id%7D/%7Baddress%7D/snapshot","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"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":{"type":"json","example":{"risk":{"level":"low","score":0,"not_an_audit":true,"not_a_vulnerability_verdict":true},"contract":{"address":"0x0000000000000000000000000000000000000000","is_contract":true,"bytecode_sha256":"<sha256>","verified_source":true},"evidence":{"source_verified":true,"bytecode_present":true},"schema_version":"0.3"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_W4Pvfq9JWSlxLV0MlvKgy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a read-only historical security intelligence snapshot for a smart contract, including risk score, bytecode hash, source verification status, and evidence metadata.","exampleAgentPrompt":"Can you pull a security snapshot for the contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum (chain ID 1) and tell me the risk level and whether the source code is verified?","exampleUseCases":[{"title":"DeFi protocol safety check before investing","prompt":"Before I deposit funds into this DeFi protocol, can you check the security risk score and source verification status for the contract 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D on Ethereum mainnet (chain ID 1)?"},{"title":"NFT marketplace contract risk assessment","prompt":"I'm about to approve a transaction with an NFT marketplace contract at 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB on chain 1 — can you get me a VulnHunt security snapshot to check its risk level and whether the bytecode has been verified?"},{"title":"Cross-chain bridge contract verification","prompt":"Can you check the VulnHunt security intelligence for the bridge contract 0x40ec5B33f54e0E8A33A975908C5BA1c14e5BbbDf on Polygon (chain ID 137) — specifically whether the source is verified and what risk score it has?"}],"resultDescription":"Returns a JSON object containing: a risk object with level (e.g. 'low'), numeric score, and disclaimer flags (not_an_audit, not_a_vulnerability_verdict); a contract object with address, is_contract boolean, bytecode SHA256 hash, and verified_source boolean; an evidence object with source_verified and bytecode_present booleans; and a schema_version string.","failureModes":["Contract address not found on specified chain — returns empty or 404 response","Invalid chain_id or unsupported blockchain — returns error","Address is an EOA (externally owned account), not a contract — is_contract will be false","No historical data available for the contract — may return null risk score","Malformed address format — returns 400 bad request","Payment not fulfilled (x402 protocol) — returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a fast, read-only historical security intelligence snapshot for a specific smart contract on a known chain, particularly for pre-transaction due diligence or DeFi risk screening. It is ideal for agents that need machine-readable risk scores and bytecode/source verification status without requiring a full on-chain audit. Prefer this over general blockchain explorers when you need structured security signals rather than raw transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:34:02.389Z","isFirstParty":false}