GET /v2/me/usage

API key usage history + current quota

curl --request GET \
  --url https://api.aegis-kyt.com/v2/me/usage \
  --header 'Authorization: Bearer <token>'

{
  "schema_version": 1,
  "billing": {
    "model": "ledger",
    "balance_usd": "42.500000",
    "monthly_spent_usd": "12.300000",
    "monthly_cap_usd": "500.000000"
  },
  "key": {
    "prefix": "aeg_N0FU",
    "name": "production-backend"
  },
  "rows": [
    {
      "id": "f7e6d5c4-b3a2-4190-8f7e-6d5c4b3a2190",
      "endpoint": "/v2/check-address",
      "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "network": "TRON",
      "provider": "Aegis",
      "risk_level": "sanctioned",
      "risk_score": 100,
      "quota_cost": 0,
      "http_status": 200,
      "elapsed_ms": 1840,
      "created_at": "2026-06-09T14:12:03.512+00:00"
    }
  ],
  "total": 1,
  "page": 1,
  "total_pages": 1
}

GET

usage

API key usage history + current quota

curl --request GET \
  --url https://api.aegis-kyt.com/v2/me/usage \
  --header 'Authorization: Bearer <token>'

{
  "schema_version": 1,
  "billing": {
    "model": "ledger",
    "balance_usd": "42.500000",
    "monthly_spent_usd": "12.300000",
    "monthly_cap_usd": "500.000000"
  },
  "key": {
    "prefix": "aeg_N0FU",
    "name": "production-backend"
  },
  "rows": [
    {
      "id": "f7e6d5c4-b3a2-4190-8f7e-6d5c4b3a2190",
      "endpoint": "/v2/check-address",
      "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "network": "TRON",
      "provider": "Aegis",
      "risk_level": "sanctioned",
      "risk_score": 100,
      "quota_cost": 0,
      "http_status": 200,
      "elapsed_ms": 1840,
      "created_at": "2026-06-09T14:12:03.512+00:00"
    }
  ],
  "total": 1,
  "page": 1,
  "total_pages": 1
}

Auth: Required · Cost: Free (no quota debit) · Use case: Quota visibility for self-service dashboards + pre-flight checks

Returns the same data shown in your kabinet at app.aegis-kyt.com/account?tab=api. Single source of truth — rows from user_api_usage, billing snapshot from user_billing. Use this endpoint to:

Surface “X of Y calls remaining” inside your own admin UI.
Detect quota exhaustion before firing a paid call (avoids a 402 round-trip).
Audit which addresses your key has screened (CSV / SOC2 reporting).

Request

curl -H "Authorization: Bearer aeg_YOUR_KEY_HERE" \
  "https://api.aegis-kyt.com/v2/me/usage?page=1&limit=20"

Query param	Type	Default	Notes
`page`	int ≥ 1	`1`	1-indexed page number
`limit`	int 1–100	`20`	Rows per page
`since`	ISO date	—	Filter to rows with `created_at >= since`

Response 200

{
  "schema_version": 1,
  "billing": {
    "monthly_quota":    15,
    "used_this_month":  3,
    "remaining":        12,
    "period_start":     "2026-05-01",
    "period_end":       null
  },
  "key": {
    "prefix": "aeg_x4k2",
    "name":   "production"
  },
  "rows": [
    {
      "id":            842,
      "endpoint":      "/v2/screen",
      "address":       "TScSLnUodZVsgoGchZspDoimDjDB9bwqVv",
      "network":       "TRON",
      "provider":      "Aegis",
      "risk_level":    "medium",
      "risk_score":    50,
      "quota_cost":    1,
      "http_status":   200,
      "elapsed_ms":    90,
      "created_at":    "2026-05-11T14:33:12.481Z"
    }
  ],
  "total":       3,
  "page":        1,
  "total_pages": 1
}

`billing` object

Field	Type	Notes
`monthly_quota`	int \| null	Plan-level cap. `null` when the user has no billing row yet (pre-onboarding state)
`used_this_month`	int \| null	Quota units already consumed in the current period
`remaining`	int \| null	`max(0, monthly_quota - used_this_month)`
`period_start`	ISO date \| null	Start of the current billing period (UTC)
`period_end`	ISO date \| null	Reserved for future plans with non-monthly cadences

When monthly_quota is null, the user has not been onboarded onto a paid plan yet. Calls will return 402 until the kabinet provisions a plan.

`rows[]` — usage history

Each row mirrors one entry in user_api_usage.

Field	Type	Notes
`id`	int	Monotonic per-user ID
`endpoint`	string	Path called (`/v2/check-address`, etc.)
`address`	string \| null	Looked-up address. Null for non-screening endpoints
`network`	string \| null	`BSC` / `ETH` / `TRON` / …
`provider`	string \| null	`Aegis` / `provider_b` / `provider_a` / `consensus`. Null for free probes
`risk_level`	enum \| null	`none` / `low` / `medium` / `high` / `critical` / `sanctioned`
`risk_score`	int 0–100 \| null	Aggregated score from the provider
`quota_cost`	int	Units debited for this call. `0` for free + refunded calls
`http_status`	int	Wire status code (`200`, `402`, `502`, …)
`elapsed_ms`	int \| null	Server-side latency
`created_at`	RFC 3339	UTC timestamp

Pagination

Field	Type	Notes
`total`	int	Total matching rows (respecting `since`)
`page`	int	Echo of the requested page
`total_pages`	int	`ceil(total / limit)` — always ≥ 1

Errors

HTTP	code	Why
401	`missing_api_key`	No `Authorization: Bearer …` header
401	`invalid_api_key`	Unknown / revoked key
422	validation	`page < 1` / `limit` out of 1–100 / non-ISO `since`

Notes

This endpoint does not debit quota — call it as often as you like.
Best-effort write semantics on user_api_usage: in extremely rare cases (Supabase write fails) a paid call’s row may be missing. Billing is unaffected — it’s computed from consume_quota on the hot path, not from this audit table.
For programmatic billing-period detection, also check period_start changes — when it increments, your monthly quota has reset.

Request

Response 200

`billing` object

`rows[]` — usage history

Errors

Notes

See also

Authorizations

Query Parameters

Response

​Request

​Response 200

​billing object

​rows[] — usage history

​Pagination

​Errors

​Notes

​See also

Authorizations

Query Parameters

Response

Request

Response 200

`billing` object

`rows[]` — usage history

Pagination

Errors

Notes

See also