KYA / counterparty check for a wallet (and optional name)

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

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://kya.lonestaroracle.xyz/check

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "chain": "base",
    "name": "OFAC",
    "wallet": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "category": "compliance",
  "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 sanctioned, mixer, phishing, money laundering), and returns PASS / REVIEW / BLOCK with plain-language reasons. The verdict is signed as an LSO Receipt (secp256k1 / EIP-191) so the result can be verified independently and passed on-chain: ethers.verifyMessage must recover LSO's published signer. Compliance is checked off-chain; the verified result travels. $0.10 in USDC on Base or Solana via x402. Sources: OFAC SDN (refreshed daily), GoPlus, public RPC.",
  "name": "KYACheck",
  "properties": {
    "input": {
      "properties": {
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "chain": {
              "default": "base",
              "description": "EVM chain for on-chain risk: base, eth, arb, poly, bsc",
              "title": "Chain",
              "type": "string"
            },
            "name": {
              "description": "Optional agent, company or person name to screen against OFAC",
              "title": "Name",
              "type": "string"
            },
            "wallet": {
              "description": "Agent/counterparty wallet address (EVM 0x... or any OFAC-listed crypto address)",
              "title": "Wallet",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "checked_at": "2026-09-24T17:00:00Z",
          "ofac_name": null,
          "ofac_wallet": {
            "currency": "ETH",
            "listed": true,
            "program": "CYBER2",
            "sdn_name": "EXAMPLE ENTITY"
          },
          "reasons": [
            "wallet is on the OFAC SDN list (EXAMPLE ENTITY, program CYBER2)"
          ],
          "receipt": {
            "receipt": {
              "checked_at": "2026-09-24T17:00:00Z",
              "service": "KYA Check",
              "verdict": "BLOCK"
            },
            "signature": {
              "alg": "secp256k1-eip191",
              "sig": "0x...",
              "signer": "0x54aB6b8Ddbedc057F230D1b78E6cd4677d304E18"
            }
          },
          "verdict": "BLOCK",
          "wallet_risk": {
            "chain": "base",
            "risk_flags": [
              "sanctioned"
            ],
            "risk_label": "critical",
            "risk_score": 10
          }
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "tags": [
    "kya",
    "sanctions",
    "ofac",
    "compliance",
    "wallet-risk"
  ],
  "type": "object",
  "version": "1.0.0"
}

This page as JSON