AI Agent 与模型付费 Token 每日用量历史存
数据集简介
谁需要这份数据
OpenRouter 会发布实时的 App & Agent Rankings 榜单,展示每个 app 实际烧掉的 token 数量,但这份榜单没有历史 API——昨天的排行榜一旦被刷新就永远消失。token-history 正是为填补这段空白而生:它把榜单每天两次的快照提交进仓库,让「哪些 agent 和模型被真正使用」这件事变成一条可以回溯、可以对比的时间线。
如果你需要观察某个 app 或模型在付费 token 口径下的用量走势、排名变化、请求量波动,或者想把这些曲线放进自己的 README 与看板,这份归档就是现成的数据底座。
使用数据
归档以纯 JSON 文件形式存放在仓库中,可直接经 raw URL 获取,无需任何密钥。主要文件结构如下:
| 文件 | 内容 |
|---|---|
data/latest.json |
最新快照指针 |
data/apps/YYYY-MM-DD.json |
每日全量快照 |
data/series/<app>.json |
每个 app 的时间序列,points = [date, day_tokens, day_rank, day_requests, stars, week_tokens, week_rank] |
data/index.json |
当前排名与 app 列表 |
data/overtakes.json |
超越事件记录 |
repos.json |
app slug 与 GitHub 仓库映射 |
时间序列中的每个 point 依次包含日期、当日 token 用量、当日排名、当日请求次数、star 数、当周 token 用量与当周排名,便于直接用于绘制对比图表或做趋势分析。
README 徽章与实时图表
仓库提供 README 徽章与对比图表能力,可把某个 app 或模型的 token 用量曲线嵌入自己的项目主页,让读者一眼看到用量与排名的变化。结合 data/overtakes.json 中的超越事件记录,还能提示「谁超过了谁」以及用量衰退的情况。
自行运行
抓取流程零依赖,需要 Node 20+。数据由 GitHub Actions 每天两次快照并提交(git scraping),归档本身就是这个仓库。你可以按同样的方式运行自己的抓取,得到一份独立维护的历史记录。
方法论——引用前请阅读
数据来自榜单页面自身调用的 JSON 端点 /api/frontend/rankings/apps,是真实的每日 token 总量。需要特别注意口径:这里衡量的是付费 token 的实际消耗,而不是 star 这类可以人为购买、只增不减的指标。模型数据有官方 API,可回溯至 2025-01-01;app 数据则从本归档开始抓取时起逐步累积。引用时请标注数据归属:Source: OpenRouter (openrouter.ai/rankings)。本项目为公开免费数据,未与 OpenRouter 隶属。
为什么不用 star
star 只会往上涨——它无法反映用量下滑。而 token 用量曲线是可以下跌的,这正是它能揭示真实使用情况的原因。token-history 选择以付费 token 作为度量,就是为了看到那些会下降的信号。
路线图
项目持续迭代中,后续计划围绕归档能力与提醒机制继续完善。