> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aegis-kyt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> aegis-kyt.com release notes (x402 + V2 API).

## 2026-08-09

**`GET /v2/sanctioned/lookup` retired.**

* 🗑️ Removed the name/slug sanctions-roster probe. It saw effectively no
  traffic since it shipped in May, and address screening —
  [`/v2/screen`](/api-reference/v2-screen) and
  [`/v2/check-address`](/api-reference/v2-check-address) — covers the
  cases customers actually asked for. Calls now return `404`.
* 📄 The reference for it is gone from this site along with the endpoint.

## 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`](/endpoints/check-address)
  (`$1.00`), `/screen/tx` → [`/check-transfer`](/endpoints/check-transfer) (`$0.50`).
* ✏️ V2 now mirrors x402 1:1 at the same prices: `checkAddressLight` →
  [`/v2/screen`](/api-reference/v2-screen) (`$0.10`), `checkAddress` →
  [`/v2/check-address`](/api-reference/v2-check-address) (Aegis-only, `$1.00`),
  new [`/v2/check-transfer`](/api-reference/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.

## 2026-05-20

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

* 🎉 New nav group [Webhooks](/webhooks/overview) 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](/webhooks/events#tx-policy-alert-triggered).
* 🎉 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](/webhooks/manage#send-a-synthetic-test-event).
* 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](/endpoints/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](/endpoints/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`.

## 2026-05-05

**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](/endpoints/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](/api-reference/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](/api-reference/v2-introduction)
  navigation group.  Pricing-vs-x402 explainer added there too.

## 2026-04-30

**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:**

* Real handler logic (Phase 3) — currently stubs.
* Mainnet flip (Phase 8).
* Per-payer rate-limiting, daily revenue digest (Phase 7).
* Bulk-screen (`POST /screen/bulk`) — defer until paying customer asks.

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