Public Stats
Read anonymized, aggregated public usage statistics. No authentication required.
All endpoints below are public — no auth is required and only anonymized aggregates are returned; no personal information or individual request content is included. The per-app token leaderboard (GET /v1/stats/apps) is covered on the App Attribution page.
Per-model call stats#
Returns the top 20 models by call count in the period, plus the total call count. The default period is daily.
| Parameter | Type | Required | Description |
|---|---|---|---|
| period | string | Optional | daily | weekly | monthly. |
{
"period": "daily",
"generated_at": "2026-07-03T09:00:00+00:00",
"total_calls": 4210,
"top_models": [
{"model": "gpt-4o-mini", "calls": 1840},
{"model": "claude-sonnet-4-6", "calls": 920}
]
}Leaderboard & market share#
The counterpart of OpenRouter's rankings. Returns the top-20 model leaderboard (leaderboard) ranked by token usage and the top-12 provider market share (market_share). Failed calls (status code 400 or above) are excluded. The default period is weekly.
| Parameter | Type | Required | Description |
|---|---|---|---|
| period | string | Optional | daily | weekly | monthly. |
{
"period": "weekly",
"generated_at": "2026-07-03T09:00:00+00:00",
"total_tokens": 48210000,
"leaderboard": [
{
"rank": 1,
"model": "claude-sonnet-4-6",
"provider": "anthropic",
"maker": "Anthropic",
"tokens": 21400000,
"calls": 8120,
"trend_pct": 12.4
}
],
"market_share": [
{"provider": "anthropic", "tokens": 21400000, "share_pct": 44.4},
{"provider": "openai", "tokens": 15200000, "share_pct": 31.5}
]
}maker is the model's creator (lab) while provider is the hosting provider. trend_pct is the token change (%) versus the previous period, and is null when there is no prior data. share_pct is the share (%) of the top-12 provider total.
Token usage timeseries#
A per-bucket × top-N-model token usage timeseries. The top N models by total tokens over the range get individual series; the rest are folded into "Others". Only the token-billed (text) modality is aggregated, and only token counts are returned — cost is not exposed.
| Parameter | Type | Required | Description |
|---|---|---|---|
| range | string | Optional | 30d | 12w | 24w. Default 30d. |
| granularity | string | Optional | day | week. Default day. Weeks are ISO weeks (Monday start). |
| top | integer | Optional | Number of top models exposed as individual series. 1 to 20, default 8. |
{
"range": "30d",
"granularity": "day",
"generated_at": "2026-07-03T09:00:00+00:00",
"series": ["gpt-4o-mini", "claude-sonnet-4-6", "Others"],
"points": [
{
"t": "2026-07-02",
"tokens": {"gpt-4o-mini": 820000, "claude-sonnet-4-6": 610000, "Others": 90000},
"total": 1520000
}
],
"total_tokens": 48210000
}trend_pct may be null.