Skip to main content
GET
/
.well-known
/
x402.json
x402 service discovery
curl --request GET \
  --url https://x402.aegis-kyt.com/.well-known/x402.json
{
  "name": "Aegis KYT x402 API",
  "description": "Per-address AML labels + risk screening, paid in USDC on Base. Powered by the Aegis 4-tier consensus engine.",
  "services": [
    {
      "endpoint": "/screen/{chain}/{address}",
      "description": "All labels for the address + consensus risk score.",
      "price": "0.10",
      "asset": "USDC",
      "network": "base-sepolia",
      "available": true
    },
    {
      "endpoint": "/check-address/{chain}/{address}",
      "description": "Aegis full 4-tier verdict (SDN + consensus + 1-hop + BFS).",
      "price": "1.00",
      "asset": "USDC",
      "network": "base-sepolia",
      "available": true
    },
    {
      "endpoint": "/check-transfer/{chain}/{tx_hash}",
      "description": "Transaction Check (KYT) — sync <=30s or 202 + free retry URL.",
      "price": "0.50",
      "asset": "USDC",
      "network": "base-sepolia",
      "available": true
    }
  ]
}
Free, no payment required. Returns the live price list — kept in sync with the actual middleware config so an out-of-band dashboard can’t drift from what the API enforces.

​
Request

curl https://x402.aegis-kyt.com/.well-known/x402.json

​
Response

{
  "name":        "Aegis KYT x402 API",
  "description": "Per-address AML labels + risk screening, paid in USDC on Base. Powered by Aegis 4-tier consensus + additional consensus inputs.",
  "services": [
    {
      "endpoint":    "/screen/{chain}/{address}",
      "description": "Per-source labels + Aegis consensus risk score in one call.",
      "price":       "0.10",
      "asset":       "USDC",
      "network":     "base",
      "available":   true
    },
    {
      "endpoint":    "/check-address/{chain}/{address}",
      "description": "Aegis full 4-tier verdict (SDN + consensus + 1-hop + BFS).",
      "price":       "1.00",
      "asset":       "USDC",
      "network":     "base",
      "available":   true
    },
    {
      "endpoint":    "/check-transfer/{chain}/{tx_hash}",
      "description": "Transaction Check (KYT): decode + Tier 4 BFS + policy.",
      "price":       "0.50",
      "asset":       "USDC",
      "network":     "base",
      "available":   true
    }
  ]
}

​
Schema

FieldTypeNotes
namestringHuman-readable service name
descriptionstringOne-line marketing copy
services[]arrayPaid tiers offered by this service
services[].endpointstringOpenAPI-style path template ({chain}/{address} placeholders)
services[].descriptionstringOne-line tier description
services[].pricestringUSDC amount as a decimal string ("0.10" = $0.10)
services[].assetstringAlways "USDC" for now
services[].networkstringFriendly network name ("base"). See networks for the full list
services[].availableboolfalse → tier is advertised so clients can plan against the future shape, but live calls return 503 until ops flips the flag

​
Tier history

  • 2026-05-05 — /label ($0.10) and /screen/light ($0.20) removed. Their data was merged into the new /screen/{chain}/{address} tier above for $0.10. Old paths now return 404.
  • 2026-04-30 — initial 4-tier launch.

​
Conventions

  • The endpoint strings are templates, not regex patterns. Use {chain} and {address} as placeholders matching the values from networks.
  • The price-list is the SINGLE SOURCE OF TRUTH at runtime — the middleware uses the same data to build payment-required quotes, so what’s listed is what you’ll be charged.

Response

200 - application/json

Successful Response

The response is of type Response Discovery Well Known X402 Json Get · object.