{"uid":"cap_vKQ9WRwojcJEM7RMLiGG6","slug":"sys84-wallet-risk-snapshot-e292a52c","name":"SYS84 Wallet Risk Snapshot","description":"Cheap wallet risk snapshot for agents: score an EVM wallet before allowlisting, paying, routing, or trading with it. Returns risk score, verdict, reasons, and compact wallet signals.","url":"https://api.sys84.org/v1/services/wallet_risk_snapshot","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"body":{"type":"object","properties":{"chain":{"type":"string","description":"string optional, only base is supported"},"address":{"type":"string","description":"string EVM wallet address to score"},"refresh":{"type":"boolean","description":"boolean optional, all calls currently read fresh upstream data"}}},"type":{"type":"string","const":"http"},"method":{"enum":["GET","POST","PUT","PATCH","DELETE","HEAD"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","properties":{"chain":{"type":"string","description":"string optional, only base is supported"},"address":{"type":"string","description":"string EVM wallet address to score"},"refresh":{"type":"boolean","description":"boolean optional, all calls currently read fresh upstream data"}}}}},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ts":{"type":"number","description":"number Unix observation timestamp"},"quality":{"type":"object","description":"object partial/degraded state, unavailable sources, provider status, data age seconds, and confidence"},"reasons":{"type":"array","description":"array of machine-readable reason codes including invalid_wallet_address, zero_address_not_payable_wallet, wallet_security_flags, no_onchain_history, thin_onchain_history, established_wallet, many_token_positions, no_wallet_risk_flags, and provider_data_partial"},"refresh":{"type":"boolean","description":"boolean whether fresh upstream checks were requested"},"signals":{"type":"object","description":"object tx count, token positions, whale tier, and safety flags"},"sources":{"type":"object","description":"object provider and risk-model identifiers"},"verdict":{"type":"string","description":"string allow/allow_with_limits/review/deny"},"risk_level":{"type":"string","description":"string minimal/low/medium/high/invalid"},"risk_score":{"type":"number","description":"number 0-100, higher is riskier"}}}}}}},"responseSchema":{"type":"json","example":{"reasons":[],"signals":{},"verdict":"string","risk_level":"string","risk_score":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_i9cbC3QINIGbzwFVPAqM5","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":"Scores an EVM wallet address for on-chain risk, returning a risk score, risk level, verdict, and supporting signals for agent-driven access control decisions.","exampleAgentPrompt":"Can you run a risk snapshot on wallet 0x1234abcd...5678 on the Base chain and tell me whether it should be allowed, reviewed, or denied — I want the risk score and the reason codes too.","exampleUseCases":[{"title":"DeFi app pre-trade wallet gate","prompt":"Before letting this wallet 0xAbCd...1234 execute a swap on my Base chain app, run a risk check and tell me the risk level and verdict — if it's high or deny, I want the reason codes so I can log them."},{"title":"Compliance review for whale addresses","prompt":"I have a wallet 0x9999...BEEF that just moved a large amount on Base — can you get its on-chain risk score and whale tier signals so I can decide whether to flag it for manual compliance review?"},{"title":"Fraud detection in payment flow","prompt":"Someone is trying to pay through our platform using wallet 0xDEAD...C0DE on Base — can you pull a fresh risk snapshot with refresh enabled and tell me if it's safe to allow or if we should block it?"}],"resultDescription":"Returns a JSON object containing: a numeric risk_score (0–100, higher means riskier), a risk_level string (minimal/low/medium/high/invalid), a verdict string (allow/allow_with_limits/review/deny), an array of machine-readable reason codes explaining the risk factors, and a signals object with supporting on-chain data including transaction count, token positions, whale tier classification, and safety flags.","failureModes":["Invalid or malformed EVM address returns an 'invalid' risk_level and a risk_score indicating unscoreable state","Unsupported chain identifier may result in an error or fallback to Base chain behavior","Payment failure via x402 protocol results in the call not being processed","Upstream data unavailability may cause stale signals to be returned unless refresh=true is set","Missing required address field returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need a fast, per-call on-chain risk score for an EVM wallet address with structured verdict output (allow/deny/review) suitable for automated agent decision-making. It is well-suited for DeFi platforms, payment gateways, and compliance workflows that need machine-readable risk reason codes and on-chain signals like whale tier and token positions. Prefer this over generic blockchain explorers when you need a scored, actionable verdict rather than raw transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:38:04.077Z","isFirstParty":false}