Changelog - Aegis KYT

2026-06-01

API unified to a single Aegis verdict — consensus tier removed.

🗑️ Removed the multi-provider consensus tier: x402 GET /screen/consensus ($2.00) and V2 POST /v2/checkAddressConsensus are gone.
✏️ Renamed for symmetry: x402 /screen/deep → /check-address ($1.00), /screen/tx → /check-transfer ($0.50).
✏️ V2 now mirrors x402 1:1 at the same prices: checkAddressLight → /v2/screen ($0.10), checkAddress → /v2/check-address (Aegis-only, $1.00), new /v2/check-transfer ($0.50).
Third-party scoring still runs under the hood (opt-in) when the on-chain graph is sparse — folded into the single Aegis verdict, no separate provider selection.

Webhooks documented + new tx.policy.alert.triggered event.

🎉 New nav group Webhooks covers events, HMAC signature format, retry policy, and the full CRUD on /v1/webhooks/*.
🎉 New event type tx.policy.alert.triggered — fires when a KYT /check-transfer (or /v1/aegis/tx) check raises a policy alert above your alert_min_level. Body shape + alert fields in Event schemas.
🎉 New POST /v1/webhooks/{sub_id}/test — fire a synthetic delivery through the same HMAC + retry plumbing real events use, so you can verify your receiver before going live. See Manage subscriptions.
The other events (aegis.bfs.completed, aegis.bfs.failed, aegis.check.high_risk) have been live for a while but weren’t documented externally — fixed now.

x402: new GET /check-transfer/{chain}/{tx_hash} tier — Transaction Check (KYT).

🎉 New GET /check-transfer/{chain}/{tx_hash} ($0.50) — submit an on-chain transaction hash, get back AML policy alerts for every sender that funded the tx. Decode + Tier 4 BFS exposure analysis + USD-weighted composite + BitOK Standard Policy. See /check-transfer.
Synchronous wait up to 30 s. If the underlying check completes in that window: 200 with the full result. If not: 202 with a check_id and a free retry URL — you pay only once per (chain, tx_hash).
🎉 New GET /check-transfer-result/{check_id} — free, rate-limited, idempotent. Fetch the deferred result from the 202 retry URL. See /check-transfer-result.
Path collision note: the retry URL is tx-result (hyphen), not tx/result (slash). The x402 SDK matches paid paths as regex; a child path would otherwise double-charge. Hyphenated sibling guarantees no overlap.
/check-transfer supports ETH, BSC, POLYGON, BASE, ARBITRUM, TRON. Same chain set as /screen and /check-address.

x402 tier consolidation: 4 → 3 paid tiers.

🎉 New GET /screen/{chain}/{address} ($0.10) — returns per-source labels plus the Aegis consensus risk verdict in one body. See /screen.
🗑️ Removed GET /label/{chain}/{address} ($0.10).
🗑️ Removed GET /screen/light/{chain}/{address} ($0.20).
Customers using either old path were paying twice for what is essentially one DB join — they now get the same data for $0.10 via /screen. Daily revenue digest showed zero callers on the old paths, so they were removed cleanly with no deprecation period.
/check-address ($1.00) and /screen/consensus ($2.00) unchanged. /screen/consensus is still gated by Phase 8 burn-in — discovery doc advertises it with available: false.

V2 API: new POST /v2/screen.

Server-side mirror of x402 /screen — same SQL, same labels[] shape, same risk fields — billed via subscription quota instead of on-chain USDC. See /v2/screen.
1 quota unit per call. Supports BSC / ETH / TRON (Aegis ingestion footprint). Supabase reachability failures (502 backend_unavailable) refund the quota.
Designed for high-volume B2B integrations: a wallet running a pre-send screen on every user-typed address should call this endpoint instead of x402 /screen — same data, settled via subscription quota without a per-call on-chain step.
New page added to the V2 introduction navigation group. Pricing-vs-x402 explainer added there too.

MVP launch — Phase 1 + 2 + 6.

🎉 https://x402.aegis-kyt.com/ is live. Landing page, discovery, health probe, and the four paid tier endpoints (/label, /screen/light, /check-address, /screen/consensus) all serve the x402 402 Payment Required quote.
Settlement: Base Sepolia (testnet) for the first 24 h burn-in. Production flip to Base mainnet pending end-to-end paid-call validation.
Tier handlers return STUB JSON ({schema_version, tier, todo: …}) pending Phase 3 wiring of real label / risk queries.
Coinbase x402 SDK (x402[fastapi,evm,httpx]>=2.8) handles EIP-3009 signature verification + Coinbase-facilitator settlement.
Audit log lands in public.x402_payments (one row per verified proof) with UNIQUE(payer, nonce) replay-protection.

What’s NOT shipped yet:

Internal roadmap tracks open follow-ups; release notes update here as each milestone ships.