---
title: "GET /api/v1/{context_id}/traces/stats"
method: GET
path: "/api/v1/{context_id}/traces/stats"
---

# GET /api/v1/{context_id}/traces/stats

`GET /api/v1/{context_id}/traces/stats`

Get aggregate query trace statistics

## Path parameters

- `context_id` string, required

## Response `200`

- TraceStatsResponseJson
  - `avgLatencyMs` number, double, required
  - `cacheHitRate` number, double, required — Phase 7.6 — `response_traces_cached / response_traces_total`.
  - `cacheHits` integer, required
  - `contradiction` ContradictionStatsJson, required — §15 operational signal (#174): cross-provenance contradiction rate.
    - `contradictionRate` number, double, required
    - `contradictions` integer, required
    - `reconciliations` integer, required
  - `responseTracesCached` integer, required — Phase 7.6 — subset with `reused_from IS NOT NONE` (served from the entity-aware cache).
  - `responseTracesTotal` integer, required — Phase 7.6 — `response_trace` rows in the configured window.
  - `retrieval` RetrievalStatsJson, required — §15 operational signal (#174): retrieval candidate-set breadth.
    - `avgCandidateSet` number, double, required
    - `maxCandidateSet` integer, required
    - `traces` integer, required
  - `sourceKindDistribution` SourceKindCountJson[], required — §15 operational signals (#174), aggregated over the same window: distribution of attribute provenance by `source.kind`.
    - `count` integer, required
    - `kind` string, required
  - `supersession` SupersessionStatsJson, required — §15 operational signal (#174): supersession churn.
    - `churnPerEntity` number, double, required
    - `entitiesChurned` integer, required
    - `supersessionEvents` integer, required
  - `tierCounts` TierCountsJson, required
    - `direct` integer, required
    - `fullContext` integer, required
    - `hybrid` integer, required
  - `totalQueries` integer, required
  - `windowHours` integer, required — Phase 7.6 — window over which the response-trace counts were aggregated.

## Other responses

- `401` — Unauthorized
- `422` — Invalid context id

---

[API](https://skmtc.net/surrealdb/apis/spectron.md) · [All operations](https://skmtc.net/surrealdb/apis/spectron/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surrealdb/spectron/revisions/52b41ab517b6/schema)