Auto-generated. This article is rebuilt from FastAPI route introspection by scripts/build_api_kb.py. Edit the route docstring in app/ and re-run the script — do not edit this file directly.

GET /api/v1/screener/calibration

Handler: app.screener.routes.get_screener_calibration_route
Methods: GET

Description

Per-archetype screener calibration summary.

Wraps app.signals.screener_predictions.get_screener_calibration(db). Returns per-archetype hit-rate, CI, and sample size for all matured screener_predictions rows.

Honesty contract (DOCTRINE P0): Every archetype is labeled calibrated: False until it accumulates min_matured_samples (from screener_config.json, default 30) matured rows. Maturation requires 30–45 REAL calendar days. Empty / immature data returns HTTP 200 with honest labels — NEVER a 404 and NEVER a fabricated hit-rate.

The label field carries a human-readable summary:

• "calibrated" — min samples met; hit_rate is meaningful.
• "uncalibrated (N/min)" — shows current sample size and the floor.

Curl

curl -s https://bigclawd.com/api/v1/screener/calibration