API docs

POST /api/screen

Screens one address. The chain is detected from the address format.

curl -X POST https://unykorn.ai/api/screen \
  -H "content-type: application/json" \
  -d '{"address":"0x098B716B8Aaf21512996dC57EB0615e2383E2f96"}'

{
  "address": "0x098B…2f96",
  "chain": "evm",
  "mode": "live",
  "decision": "deny",          // allow | review | deny
  "score": 100,                // 0–100
  "checks": [
    { "source": "OFAC SDN", "status": "hit", "detail": "Listed: …" },
    { "source": "Circle USDC blacklist (Ethereum)", "status": "pass", "detail": "…" }
  ],
  "sdn_publish_date": "…",
  "screened_at": "2026-09-18T…Z",
  "decision_hash": "sha256…"
}

GET /api/status

Shows which sources are loaded and the date of the sanctions list in use.

Rules

• deny: any hit on sanctions, issuer freeze or the sandbox rule.
• review: any source unavailable, an unrecognised format, or a ledger-level freeze.
• allow: every source answered and none matched.
• Sandbox: addresses containing BLOCKED, SANCTION or OFAC always return deny.

Sources

Coming next: hack, mixer and drainer labels, SAR draft export, API keys, and pay-per-screen over x402.