# x402 AI Agent Identity — Sanctions Screening

> x402 AI Agent Identity — Sanctions Screening is a paid API for AI agents from kyc.madhousewallet.com, paid per call via x402, $0.02/call, status down (last checked 2026-09-15).

Screens an EVM or Solana wallet address against global sanctions lists and returns a boolean sanctioned flag with matched entity details.

## Facts

- Endpoint: GET https://kyc.madhousewallet.com/api/public/kyc/sanctions
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-ai-agent-identity-sanctions-screening-b35934d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1OpnkwgO832tiwnM4zIUN

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 x402-ai-agent-identity-sanctions-screening-b35934d4
```

Example prompt: Can you check if this wallet address 0xef616c29859b101167f3ea6bb69faee733d573f7 is on any sanctions lists before I send funds to it?

## When to prefer this

Use this endpoint when you need real-time sanctions screening for an EVM or Solana wallet address before executing a transaction, onboarding a counterparty, or establishing an AI agent identity. Prefer this over manual OFAC lookups when operating in a programmatic, agent-driven context where low per-call cost ($0.02 USDC) and on-chain attestation via the x402 protocol are required. Ideal for DeFi, payments, and compliance workflows that need machine-readable, structured sanction match data without requiring account setup.

## Known failure modes

- Invalid wallet address format — returns error if address is not a valid 0x EVM or base58 Solana address
- Payment failure — $0.02 USDC x402 payment not confirmed, request rejected
- Network unavailable — underlying sanctions data provider unreachable
- Missing wallet parameter with no paying wallet context — cannot determine address to screen

## How this service works

KYC identity for AI agents. Pay once with USDC on 6 networks, verify your wallet, and get a permanent on-chain attestation every x402 API can read. No accounts, no repeated sign-ups.

## Output

Returns a JSON object with: `sanctioned` (boolean — true if matched, false if clean), `matchCount` (number of distinct sanctioned entities matched), `matches` (array of matched entity details including caption, countries, entityType, topics, and datasets), and `walletAddress` (the queried address). An empty `matches` array with `sanctioned: false` indicates a clean wallet.

## Request schema (JSON Schema)

```json
{
 "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"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "wallet": {
       "type": "string",
       "description": "Wallet address to screen (0x EVM or base58 Solana). If omitted, the paying wallet is used."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "matches": {
       "type": "array",
       "description": "Matched entity details. Each entry has caption, countries, entityType, topics, datasets. Empty when sanctioned: false."
      },
      "matchCount": {
       "type": "number",
       "description": "Number of distinct sanctioned entities matched."
      },
      "sanctioned": {
       "type": "boolean",
       "description": "True when one or more sanctioned entities matched. False means clean."
      },
      "walletAddress": {
       "type": "string",
       "description": "The queried wallet address."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "matches": [],
  "matchCount": 0,
  "sanctioned": false,
  "walletAddress": "0xef616c29859b101167f3ea6bb69faee733d573f7"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-ai-agent-identity-sanctions-screening-b35934d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kyc.madhousewallet.com](https://www.zero.xyz/host/kyc.madhousewallet.com/llms.txt)