Skip to main content
Surface: https://api.aegis-kyt.com/v2/*
The V2 API is the subscription-billed counterpart to x402. Where x402 is per-call USDC for AI agents that don’t want accounts, V2 is the traditional API model for businesses that want monthly quotas, predictable bills, and human-issued keys. Both surfaces run the SAME Aegis 4-tier engine + same external providers (provider_b, provider_a). Pick whichever fits your usage model.

​
Pricing vs x402 — same logic, different channels

Some V2 endpoints return data that x402 also sells. The compute is identical (same SQL, same Python aggregator) — what differs is the settlement rail: Most direct overlap: Practical consequence: if you’re a partner wallet putting a screen behind every “send to address” prompt for your users — use the V2 API. x402 is for callers who don’t have an account relationship with us.

​
Quickstart

​
Endpoints

Billing is per your plan / commercial agreement. See the per-endpoint pages for full request/response shapes.

​
Authentication

  • One active key per user.
  • Plaintext shown once at creation. Server stores SHA-256 only.
  • Revoke / rotate via /account?tab=api in your kabinet.
  • Missing or invalid key → HTTP 401.

​
Quota

Each successful call deducts quota units from your monthly balance. Cost per call:
  • Consensus charges the sum of providers that ran. Unsupported-network skips are free.
  • Quota exceeded → HTTP 402 with code: quota_exceeded.
  • Current quota and balance: call GET /v2/me/usage or visit your kabinet at app.aegis-kyt.com.

​
Refund policy

​
Idempotency-Key

Send Idempotency-Key: <≤64 chars> header to make retries safe:
  • Same key + same body within 24h → cached response, no charge
  • Same key + DIFFERENT body → HTTP 409 idempotency_conflict
Use any high-entropy token (UUID v4 recommended).