Api Endpoint

LoneStarOracle

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

Open interactive test console

Offering

Provider
kya.lonestaroracle.xyz
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://kya.lonestaroracle.xyz/check
MIME type
application/json
First seen
2026-10-16T01:50:03.832Z
Last seen
Tags
kya, sanctions, OFAC, compliance, wallet-risk, X402, financial-data, real-economy, lonestaroracle, Macro, equities, Crypto, Risk, Data

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.1 USDC
Atomic price: 100000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.1 USDC
Atomic price: 100000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "100000",
    "payTo": "0x52Ab53912D37759B2ad364f22dD06B16714b6C06"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "100000",
    "payTo": "3nmeVj5m9Uq2hSTfsVsn3tJMHRJQNMKR1AjzyUJbrSgw"
  }
]

Observed health

Status
Healthy
Latest latency
34 ms
Average latency
132 ms
HTTP status
402
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "required": [
    "type",
    "method"
  ],
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "wallet": {
          "type": "string",
          "description": "Agent/counterparty wallet address (EVM 0x... or any OFAC-listed crypto address)",
          "title": "Wallet"
        },
        "name": {
          "type": "string",
          "description": "Optional agent, company or person name to screen against OFAC",
          "title": "Name"
        },
        "chain": {
          "type": "string",
          "description": "EVM chain for on-chain risk: base, eth, arb, poly, bsc",
          "default": "base",
          "title": "Chain"
        }
      }
    }
  }
}

Output schema

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