Skip to main content

​
Aggregate stats

GET /api/v1/stats/
Optional query:
  • days=<int>: look back N days
Returns totals such as total runs/actions/cost and average cost/duration per action.

​
Daily stats

GET /api/v1/stats/daily
Returns cost and run counts grouped by day (last 30 days).

​
Cost-estimate accuracy

GET /api/v1/stats/estimation-accuracy
Compares the SDK-supplied cost_usd estimate against the actual cost recorded by LLM provider instrumentation, action by action. Returns aggregate skew (mean, p50, p95), the worst-offender actions, and per-action histograms. Useful for tuning your cost_usd decorator arguments and for surfacing budget drift in the console.