For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
ModelsChatRankingsDocs
DocsAPI ReferenceClient SDKsAgent SDKCookbookChangelog
DocsAPI ReferenceClient SDKsAgent SDKCookbookChangelog
    • Overview
    • Usage for Agents
  • TypeScript SDK
    • Overview
      • Analytics
      • APIKeys
      • Byok
      • Chat
      • Credits
      • Datasets
      • Embeddings
      • Endpoints
      • Generations
      • Guardrails
        • Models
        • RankingsDailyResponse
      • OAuth
      • Observability
      • Organization
      • Presets
      • Providers
      • Rerank
      • Beta.Responses
      • Transcriptions
      • Speech
      • VideoGeneration
      • Workspaces
  • Python SDK
    • Overview
  • Go SDK
  • DevTools
    • Overview
    • Migrating to @openrouter/agent
LogoLogo
ModelsChatRankingsDocs
On this page
  • Example Usage
  • Fields
TypeScript SDKAPI ReferenceModels

RankingsDailyResponse - TypeScript SDK

RankingsDailyResponse type definition
Was this page helpful?
Previous

OAuth - TypeScript SDK

OAuth method reference
Next
Built with

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Example Usage

1import { RankingsDailyResponse } from "@openrouter/sdk/models";
2
3let value: RankingsDailyResponse = {
4 data: [
5 {
6 date: "2026-05-11",
7 modelPermaslug: "openai/gpt-4o-2024-05-13",
8 totalTokens: "12345678",
9 },
10 {
11 date: "2026-05-11",
12 modelPermaslug: "anthropic/claude-3.5-sonnet-20241022",
13 totalTokens: "9876543",
14 },
15 ],
16 meta: {
17 asOf: "2026-05-12T02:00:00Z",
18 endDate: "2026-05-11",
19 startDate: "2026-04-12",
20 version: "v1",
21 },
22};

Fields

FieldTypeRequiredDescriptionExample
datamodels.RankingsDailyItem[]✔️Up to 51 rows per day — the top 50 public models by total_tokens for each UTC calendar date in the window, plus one aggregated other row summing every model outside that top 50 (omitted when the long tail is empty). Rows are sorted by date ascending, then by total_tokens descending, with other pinned last within its date. Ties between real models break alphabetically on model_permaslug so the order is stable across requests.
metamodels.RankingsDailyMeta✔️N/A{"as_of": "2026-05-12T02:00:00Z","end_date": "2026-05-11","start_date": "2026-04-12","version": "v1"}