Strategy stats handler

Required scope: read

GET /api/v1/reason/strategy-stats

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/reason/strategy-stats' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "epsilon": 1.5,
  "learned": [
    {
      "mean_confidence": 7.5,
      "mean_latency_ms": 250,
      "query_class": "string",
      "samples": 1,
      "strategy": "string",
      "success_rate": 7.5,
      "trusted": true
    }
  ],
  "learned_pairs": 1
}

Required scope: read

Response

StrategyStatsResponse

epsilon · number (float) · required

Current exploration rate (probability of trying a non-best strategy).

learned · StrategyStat[] · required

Per-pair performance rows, one for each observed (query-class, strategy).

Show StrategyStat

mean_confidence · number (float) · required

mean_latency_ms · integer (int64) · required

query_class · string · required

samples · integer (int64) · required

strategy · string · required

success_rate · number (float) · required

trusted · boolean · required

True once the pair has enough samples for the bandit to exploit it.

learned_pairs · integer · required

Number of learned (query-class, strategy) pairs in learned.

Status codes

Code	Meaning
200	Learned per-query-class strategy performance
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/reason/strategy-stats' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "epsilon": 1.5,
  "learned": [
    {
      "mean_confidence": 7.5,
      "mean_latency_ms": 250,
      "query_class": "string",
      "samples": 1,
      "strategy": "string",
      "success_rate": 7.5,
      "trusted": true
    }
  ],
  "learned_pairs": 1
}