# Hermes Plant WalletGuard Score

> Hermes Plant WalletGuard Score is a paid API for AI agents from hermesplant.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Scores a blockchain wallet address for AML/sanctions risk, returning a risk level, score, and actionable compliance findings including OFAC/sanctions hits

## Facts

- Endpoint: GET https://hermesplant.com/api/agent-services/walletguard/score
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-plant-walletguard-score-c1f8aa74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KIJXx6P_hoedCCVpfrde7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hermes-plant-walletguard-score-c1f8aa74
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-plant-walletguard-score-c1f8aa74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hermesplant.com](https://www.zero.xyz/host/hermesplant.com/llms.txt)