# KYACheck – OFAC & Wallet Risk Screening

> KYACheck – OFAC & Wallet Risk Screening is a paid API for AI agents from kya.lonestaroracle.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-13).

Screens an EVM wallet address (and optional entity name) against the OFAC SDN list and on-chain risk signals, returning a signed PASS/REVIEW/BLOCK verdict with plain-language reasons

## Facts

- Endpoint: GET https://kya.lonestaroracle.xyz/check?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kyacheck-ofac-wallet-risk-screening-0a1d08a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pMXNL0wHFhAzQj5UwujmG

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 kyacheck-ofac-wallet-risk-screening-0a1d08a8
```

Example prompt: Before I pay this agent, can you run a KYA compliance check on their wallet 0xAbC123...789 on Base and also screen the name 'Acme Trading LLC' against OFAC — I need a signed PASS/BLOCK verdict before I proceed?

## When to prefer this

Choose this endpoint when an AI agent or automated workflow needs a single-call, machine-readable compliance verdict before executing a payment, hiring a sub-agent, or onboarding a counterparty. It uniquely combines OFAC SDN exact-match wallet screening (~500 crypto addresses), name/entity screening against SDN and alternate-names lists, and on-chain risk scoring (GoPlus flags), all in one response with a cryptographically signed receipt — making it suitable for auditable agentic workflows. Prefer it over manual OFAC lookup tools when you need a programmatic, signed, structured verdict rather than a human-readable web interface.

## Known failure modes

- Invalid or malformed wallet address (0x... format required) returns an error
- Unsupported chain value returns an error — must be one of base, eth, arb, poly, bsc
- Missing wallet query parameter — wallet is required even if name is optional
- Network or upstream OFAC data fetch failure may return a 5xx error
- Payment failure (x402 protocol) if insufficient USDC balance — call will not be processed
- Rate limiting or abuse detection may result in rejection

## How this service works

KYA / counterparty check for a wallet (and optional name): OFAC + wallet risk + signed verdict

## Output

Returns a JSON object containing: a verdict string (PASS, REVIEW, or BLOCK), plain-language reasons array, OFAC wallet match details (listed flag, SDN name, program, currency), OFAC name match result, on-chain wallet risk assessment (risk score 0–10, risk label, risk flags such as sanctioned/mixer/phishing), checked_at timestamp, and a cryptographically signed receipt (secp256k1/EIP-191 signature with signer address) providing an auditable, tamper-evident compliance record.

## Request schema (JSON Schema)

```json
{
 "name": "KYACheck",
 "tags": [
  "kya",
  "sanctions",
  "ofac",
  "compliance",
  "wallet-risk"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "compliance",
 "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",
     "properties": {
      "name": {
       "type": "string",
       "title": "Name",
       "description": "Optional agent, company or person name to screen against OFAC"
      },
      "chain": {
       "type": "string",
       "title": "Chain",
       "default": "base",
       "description": "EVM chain for on-chain risk: base, eth, arb, poly, bsc"
      },
      "wallet": {
       "type": "string",
       "title": "Wallet",
       "description": "Agent/counterparty wallet address (EVM 0x... or any OFAC-listed crypto address)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "reasons": [
      "wallet is on the OFAC SDN list (EXAMPLE ENTITY, program CYBER2)"
     ],
     "receipt": {
      "receipt": {
       "service": "KYA Check",
       "verdict": "BLOCK",
       "checked_at": "2026-09-24T17:00:00Z"
      },
      "signature": {
       "alg": "secp256k1-eip191",
       "sig": "0x...",
       "signer": "0x54aB6b8Ddbedc057F230D1b78E6cd4677d304E18"
      }
     },
     "verdict": "BLOCK",
     "ofac_name": null,
     "checked_at": "2026-09-24T17:00:00Z",
     "ofac_wallet": {
      "listed": true,
      "program": "CYBER2",
      "currency": "ETH",
      "sdn_name": "EXAMPLE ENTITY"
     },
     "wallet_risk": {
      "chain": "base",
      "risk_flags": [
       "sanctioned"
      ],
      "risk_label": "critical",
      "risk_score": 10
     }
    }
   }
  }
 },
 "description": "Know-your-agent (KYA) / counterparty check, made agent-callable. Before your agent pays, hires or trusts another agent, one x402 call screens that agent's wallet against the US Treasury OFAC SDN list - including the ~500 crypto addresses OFAC publishes, matched exactly - optionally screens its name/entity against the SDN and alternate-names lists, scores the wallet's on-chain risk (GoPlus address-security flags such as
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kyacheck-ofac-wallet-risk-screening-0a1d08a8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kya.lonestaroracle.xyz](https://www.zero.xyz/host/kya.lonestaroracle.xyz/llms.txt)