zh zh
CN¥ cny

面向开发者的公开 API

免费的只读 JSON API:CS2、Dota 2、Rust 和 TF2 价格,CS2 分析与市场指数,带分游戏汇总的 Steam 库存估值,以及 CS2 战队与选手。多数接口需要免费的个人 API 密钥,密钥同时提高限额;市场指数和磨损值查询无需密钥。支持的参数和数据见下文。

代理服务提供方:
Skinory · Chrome

你的饰品,你的价格追踪。

保存CS2物品,关注价格变化,直接在Steam中比较各市场报价。

浏览器扩展

API 访问与个人限额

无密钥

市场指数和磨损值查询无需登录即可使用:每个 IP 地址每分钟 5 次请求。价格、报价、数据状态、掉落池、战队、选手和库存接口需要密钥。

接口

有密钥

为脚本和集成提供免费个人密钥。可访问价格、报价、数据状态、掉落池、战队、选手和库存接口,并提高限额,每个密钥单独计数。

如何获取密钥
限额无密钥有密钥
每分钟请求数5120
每小时库存请求:单个与批量需要密钥480
每分钟首次库存查询需要密钥48
每次调用 /api/v1/inventories 的资料数需要密钥100
/api/v1/float 每分钟的游戏协调器查询数1015

两个库存接口共享每小时配额;一个批次算一次请求。单个库存返回 stale: true 时不消耗此配额。首次查询指查询尚无已保存估值的个人资料。

从同一 IP 地址使用的所有密钥共享同一上限,无论属于哪个账户:每分钟 240 次请求、每小时 960 次库存请求、每分钟 96 次首次查询和 30 次游戏协调器查询。

如何获取密钥

  • 通过 Steam 登录,在个人资料页打开“API 密钥”栏目。 前往个人资料
  • 注册 Skinory 5 分钟后可创建密钥。每个账号最多拥有 3 个有效密钥,各自带有名称。
  • 密钥只在创建时显示一次,我们只保存其哈希值。丢失或泄露的密钥可一键吊销,并换成新密钥。

如何发送密钥

在 Authorization 请求头中以 Bearer 方案发送密钥,或放在 X-Api-Key 请求头中。密钥只在 /api/v1 上读取;不要把它写进在浏览器中运行的代码或公开仓库。

响应头与错误

X-RateLimit-Limit
每分钟允许的请求数
X-RateLimit-Remaining
当前窗口内剩余的请求数
X-RateLimit-Reset
距离窗口重置的秒数

输错、未知或已吊销的密钥绝不会被忽略:请求会收到带 WWW-Authenticate 的 401,而不会退回匿名限额。被封禁账号的密钥会收到 403。超出限额时返回带 Retry-After 的 429。

请求示例

使用密钥查询价格

curl -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"

使用密钥查询单个库存

向 /api/v1/inventory 传入 SteamID64、个人资料链接或自定义名称。库存必须公开。请求可能等待最多 25 秒,返回已保存估值(stale: true),或返回 503 和 Retry-After。估值时间请查看 checkedAt。

curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/inventory?steam=76561197960287930"

批量读取已保存库存

传入最多 100 个 SteamID64 或 /profiles/ 链接,以逗号分隔。/api/v1/inventories 读取已保存估值,不会联系 Steam。cached 表示存在已保存估值,unknown 表示没有。需要估值时请调用 /api/v1/inventory。

curl -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930"

一次请求获取 TF2 全部价格

curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/games/tf2/prices"

429 表示已达到 API 限额;503 表示库存估值尚未完成,或 Steam 暂时限制请求。请完整等待 Retry-After 指定的秒数,即使超过一分钟也一样,并且不要对同一个人资料同时发送重试请求。

价格时效

/api/v1/price、/api/v1/offers 以及 /api/v1/games 下 Dota 2、Rust 和 TF2 接口的价格至少延迟 6小时。请检查 pricedAt、snapshotAt 和 stale,这些不是实时报价。若尚无可用的延迟快照,API 返回 503 和 Retry-After。库存估值有独立的 checkedAt 时间。

接口

方法和参数来自 OpenAPI。标有 * 的参数为必填项。完整响应结构请参阅规范。

接口返回内容参数
GET /api/v1/droppool API 密钥正在追踪的 CS2 每周掉落池—
GET /api/v1/status API 密钥价格数据源和数据集的更新时间—
GET /api/v1/index 最新 CS2 市场指数及各类别市值lang
GET /api/v1/index/history 单个类别的 CS2 市场指数每日历史categorydayslang
GET /api/v1/inventory API 密钥估算公开 Steam 库存:CS2、Dota 2、Rust 和 TF2steam*lang
GET /api/v1/inventories API 密钥每次请求读取最多 100 个 Steam 库存的已保存估值steam*lang
GET /api/v1/price API 密钥按名称查找 CS2 物品;价格至少延迟 6小时q*langcurrency
GET /api/v1/price/history API 密钥单个 CS2 物品的每日价格历史q*dayslang
GET /api/v1/offers API 密钥单个 CS2 物品的市场报价,至少延迟 6小时name*lang
GET /api/v1/games/{game} API 密钥Dota 2、Rust 或 TF2 目录:筛选项与价格来源game*lang
GET /api/v1/games/{game}/items API 密钥Dota 2、Rust 或 TF2 物品;价格至少延迟 6小时game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang
GET /api/v1/games/{game}/items/{slug} API 密钥单个 Dota 2、Rust 或 TF2 物品及其市场报价,至少延迟 6小时game*slug*lang
GET /api/v1/games/{game}/prices API 密钥一次响应返回某个游戏的全部价格,至少延迟 6小时game*
GET /api/v1/float 通过检视链接获取 CS2 物品的磨损值、图案模板、贴纸和挂件url*lang
GET /api/v1/teams API 密钥Valve 官方排名中的 CS2 战队region
GET /api/v1/teams/{slug} API 密钥战队资料:阵容、奖杯、比赛及排名历史slug*
GET /api/v1/players API 密钥Valve 排名战队中的选手steamlimit
GET /api/v1/players/{slug} API 密钥选手资料及当前战队slug*

AI 助手的独立访问规则

可识别的 AI 助手无需密钥即可查询库存。请求配额按 IP 计算;首次查询额度由所有助手共享。每批最多 50 个个人资料。这些不是个人密钥的限额。

已知 AI 助手在 /api/v1 上每分钟请求数
120
每个 IP 每小时库存请求
240
从未估值过的资料每分钟查询数,由所有 AI 助手共享
32

规范与机器可读文件

许可

指南、编辑文章以及本站自有的衍生数据(掉落池估算、武器箱 RTP、指数、每日中位数、图案表、llms-catalog.txt 汇编)采用 CC BY 4.0 许可:请注明 Skinory 并附上来源页面链接。

战队与选手数据(/api/v1/teams、/api/v1/players)来自 Liquipedia,采用 CC BY-SA 4.0 许可:请注明 Skinory 并附链接,改编作品须以相同许可共享。

目录使用 Steam 与游戏文件数据,CS2 还使用 CSGO-API。这些内容及市场价格由第三方提供,适用原权利人的条款。

CC BY 4.0 · CC BY-SA 4.0

如何引用

请按“Skinory — 页面标题,URL,更新日期”的格式引用页面,使用规范 URL 和页面显示的日期,没有则写阅读日期。引用价格时请注明币种和时间:价格会变动。

Skinory — AK-47 | Redline, https://skinory.io/zh/items/ak-47-redline, 2026-11-16

正在浏览