{"uid":"cap_KIJXx6P_hoedCCVpfrde7","slug":"hermes-plant-walletguard-score-c1f8aa74","name":"Hermes Plant WalletGuard Score","description":"Wallet risk scoring and pre-transaction AML, sanctions, counterparty-risk, and crypto compliance screening for autonomous finance agents. Scores one wallet from caller-provided sanctions hits, exposure tags, counterparty labels, transfers, and fund-source context; returns a 0-100 risk score, evidence per signal, and a concrete action. Deterministic preflight only: no chain data is fetched and no screening result is fabricated.","url":"https://hermesplant.com/api/agent-services/walletguard/score","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"labels":{"type":"array","description":"Labels like exchange:binance, contract:..., sanctions:..."},"wallet":{"type":"string","description":"Wallet address (0x + 32-48 hex chars)"},"exposures":{"type":"array","description":"Signals e.g. mixer:tornado, sanctions:ofac"},"transfers":{"type":"array"},"sanctionsHits":{"type":"array"},"fundingSources":{"type":"array"}}},"responseSchema":{"type":"json","example":{"status":"scored","wallet":"0x9999999999999999999999999999999999999999","service":"walletguard","findings":[{"id":"sanctions.hit:0","fix":"Do not send or receive funds; freeze and escalate to compliance.","why":"Wallet appears on sanctions / OFAC / blacklist","rule":"sanctions.hit","evidence":"sanctionsHits[0]=OFAC-SDN-9999; exposures[0]=sanctions:ofac; labels[0]=high-risk:ofac-listed","severity":"critical"}],"requestId":"wg-5a6c8099","riskLevel":"critical","riskScore":50,"findingsCount":1,"recommendedAction":"block_and_escalate","fundSourceBreakdown":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ypZnpaI4_ZZmjRYSFS5l6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores a blockchain wallet address for AML/sanctions risk, returning a risk level, score, and actionable compliance findings including OFAC/sanctions hits","exampleAgentPrompt":"Before we send any funds, run a WalletGuard sanctions and AML risk score on this wallet address: 0x9999999999999999999999999999999999999999 — I need to know the risk level and whether we should block or escalate.","exampleUseCases":null,"resultDescription":"A JSON object containing: status ('scored'), the wallet address, a riskScore (0–100), riskLevel (e.g. 'critical'), findingsCount, recommendedAction (e.g. 'block_and_escalate'), an array of findings each with severity, rule ID, why it fired, evidence, and a remediation fix, plus a fundSourceBreakdown and a unique requestId for audit trails.","failureModes":["Invalid or malformed wallet address returns a 400 error","Wallet not found on any monitored chain may return empty findings with low risk score","Payment failure via x402 returns 402 with no result","Rate limiting or quota exceeded returns 429","Internal scoring engine timeout returns 503"],"whenToPreferThis":"Use this endpoint when an AI agent needs to make a compliance go/no-go decision about a counterparty wallet before executing a crypto transaction — especially when OFAC/sanctions screening is required. Prefer this over generic blockchain analytics when you need structured findings with actionable remediation steps and a deterministic, test-backed risk score payable per-call without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:44.686Z","isFirstParty":false}