GET /v1/accuracy

Returns pre-computed model accuracy metrics derived from recorded trade outcomes. Updated every 5 minutes.

Request

GET https://api.canonprotocol.org/v1/accuracy

Headers

Header	Required	Value
Authorization	Yes	Bearer YOUR_API_KEY

Response

{
  "computed_at": "2025-03-21T14:30:00Z",
  "total_outcomes": 1250,
  "brier_score": 0.18,
  "calibration_curve": [
    {
      "predicted_risk_range": "0-10",
      "count": 320,
      "actual_loss_rate": 0.08,
      "avg_pnl_pct": 4.2
    }
  ],
  "band_stats": [
    {
      "recommendation": "proceed",
      "count": 680,
      "profitable_pct": 72.5,
      "avg_pnl_pct": 3.8,
      "avg_pnl_usd": 450.20
    }
  ],
  "recent_7d": {
    "total_outcomes": 180,
    "brier_score": 0.15,
    "profitable_pct": 65.0
  }
}

Field	Type	Description
computed_at	string	ISO 8601 timestamp of last computation
total_outcomes	number	Total recorded outcomes (all time)
brier_score	number	Brier score (0 = perfect, 1 = worst). Measures prediction calibration
calibration_curve	array	Predicted risk vs actual loss rate per decile
band_stats	array	Accuracy per recommendation band
recent_7d	object or null	Rolling 7-day accuracy window. Null if no recent outcomes

Interpreting Brier Score

Brier Score	Interpretation
< 0.15	Well-calibrated model
0.15 - 0.25	Acceptable calibration
0.25 - 0.40	Needs recalibration
> 0.40	Poorly calibrated