List cache hit metrics

curl -X POST https://api.respan.ai/api/dashboard/cache-hit-metrics/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{
  "start_time": "2026-02-01T00:00:00Z",
  "end_time": "2026-02-22T23:59:59Z"
}'

[
  {
    "date_group": "2026-02-01T00:00:00Z",
    "cache_hit_count": 1520,
    "cache_hit_tokens": 485000,
    "cache_hit_cost_savings": 123.45,
    "cache_hit_percentage": 37.8
  },
  {
    "date_group": "2026-02-02T00:00:00Z",
    "cache_hit_count": 1675,
    "cache_hit_tokens": 512300,
    "cache_hit_cost_savings": 130.75,
    "cache_hit_percentage": 39.2
  },
  {
    "date_group": "2026-02-03T00:00:00Z",
    "cache_hit_count": 1580,
    "cache_hit_tokens": 498200,
    "cache_hit_cost_savings": 127.1,
    "cache_hit_percentage": 38.5
  }
]

Returns semantic cache hit metrics (count, tokens, savings, hit %) as a time series.

Request

This endpoint expects an object.

start_timedatetimeRequired

Inclusive start of the range, ISO 8601.

end_timedatetimeRequired

Inclusive end of the range, ISO 8601.

time_tickenumOptional

Bucket granularity for time-series endpoints. If omitted, inferred from the range. Has no effect on /summary/ endpoints.

Allowed values:

filtersobjectOptional

Filter criteria. See Filters API Reference for operator syntax.

Response

Successful response.

date_groupdatetime

cache_hit_countinteger

Number of requests served from cache.

cache_hit_tokensinteger

Tokens returned from cache.

cache_hit_cost_savingsdouble

Estimated cost saved.

cache_hit_percentagedouble

Cache hit rate (0-100).

Headers

Request

Response