CS2 库存查询

查询账号的 CS2 饰品库存，含饰品市场价（仅对开启了价格服务的账号有效）。

提示

如果你还需要账号的其它信息（封禁、等级、游戏库等），推荐直接用 /api/account 或 /api/accounts，在 fields 里加上 库存 一次拿全。

• URL：POST /api/cs2inventory（SSE 流式）
• 配额：N 次
• 响应类型：text/event-stream

请求体

字段	类型	必填	说明
refreshTokens	string | string[]	是	逗号分隔字符串或数组

请求示例

curl -N -X POST https://monsteronly.me/api/cs2inventory \
  -H "Authorization: Bearer sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"refreshTokens":"token1"}'

SSE 响应示例

data: {"type":"start","total":1}

data: {"type":"progress","index":0,"total":1,"processed":1,"successful":1,"failed":0,"result":{
  "success": true,
  "steamID": "76561199000000000",
  "totalCount": 2,
  "items": [
    {
      "assetId": "123456789",
      "classId": "987654321",
      "instanceId": "0",
      "amount": 1,
      "name": "AK-47 | Redline (Field-Tested)",
      "type": "Classified Rifle",
      "tradable": true,
      "marketable": true,
      "iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/xxxxx",
      "nameColor": "D2D2D2",
      "backgroundColor": null,
      "price": 85.50
    }
  ]
}}

data: {"type":"success","total":1,"successful":1,"failed":0,"quota":{"used":130,"remaining":870}}

字段说明

字段	类型	说明
totalCount	number	库存物品总数
items[].assetId	string	Steam 饰品 asset 唯一 ID
items[].name	string	饰品市场名称（market_hash_name）
items[].tradable	boolean	是否可交易
items[].marketable	boolean	是否可上架社区市场
items[].iconUrl	string	图标完整 URL
items[].price	number | null	Steam 市场售价（元），查不到时为 null

特殊情况

账号库存为空时返回：

• success: true
• items: []
• message: '该账号没有 CS2 库存或库存为空'