CS2 Skin Trade-Up Calculator

Counter-Strike 2 Trade Up Calculator API | CS2 Skin Contract Calculator | Steam API | CS2 API | ROI CALCULATOR | Skin API |

原始信息汇总

CS2 Skin Trade-Up Calculator 数据集概述

核心功能

该API是一个实时CS2（反恐精英2）皮肤交易升级计算器，可基于Steam库存计算最优交易升级合约，并提供利润分析、期望值（EV）及结果概率。它支持武器、刀/手套的交易升级，兼容StatTrak物品，并使用Valve官方的浮点归一化公式进行计算。

工作机制

交易升级合约允许用户用10件同稀有度、同收藏品的皮肤兑换1件下一稀有度级别的皮肤。自2024年10月起，5件来自同个箱子的隐秘（Covert）级皮肤可兑换一把刀或手套。该API的工作流程如下：

1. 读取用户的CS2库存或直接接受物品列表。
2. 按稀有度和收藏品对皮肤进行分组。
3. 找出所有有效的交易升级组合。
4. 使用Valve归一化公式计算输出皮肤的磨损值（Float）。
5. 获取当前市场价格，并按盈利能力对组合进行排序。

接口详情

• GET /inventory/{steamid}

  • 功能：返回来自公开Steam库存的最多300件可交易CS2物品，并附有稀有度、收藏品和当前市场价格信息，同时返回该批次的总价值。
  • 参数：steamid（必需，17位SteamID64）、cursor（可选，用于分页）
  • 注意事项：库存需设置为公开；贴纸、涂鸦和武器箱会显示稀缺度为null。

• GET /tradeups/{steamid}

  • 功能：自动获取Steam库存并计算所有有效的交易升级组合，结果按盈利能力从高到低排序。库存信息会保存在一个2小时的会话中。
  • 参数：steamid（必需，17位SteamID64）、cursor（可选，用于处理超过300件物品的库存）

• POST /tradeups

  • 功能：通过直接提供物品列表来计算交易升级组合，响应速度快。
  • 请求体格式：包含一个items数组，数组中的每个对象需包含market_hash_name（必需，物品名称包括磨损）和可选的float_value（浮点值，介于0和1之间）。

响应数据模型

字段	类型	描述
TradeupResult
type	"weapon" 或 "knife_glove"	指定是武器升级（10件）还是刀/手套升级（5件）
collection	string	物品所属的收藏品或箱子名称
inputs	array	选作升级输入的皮肤列表（最便宜的合规组合）
required_input_count	number	所需输入皮肤数量：武器为10，刀/手套为5
total_input_cost	number	所有输入皮肤的总成本（USD）
possible_outputs	array	所有可能的输出皮肤，包含其磨损值、价格和概率
best_output	object	有价格数据的最高价值输出皮肤
pricing	object	价格可用性摘要
expected_value	number	所有有价格输出的加权平均价值
profit	number	expected_value - total_input_cost
profit_percentage	number	利润相对于输入成本的百分比
PricingInfo
all_outputs_priced	boolean	所有可能的输出是否都有已知市场价格
unpriced_count	number	没有价格数据的输出数量
unpriced_outputs	array	无价格数据的皮肤名称列表
note	string or null	当前输出存在无价格物品时的警告信息
OutputSkin
name	string	包含磨损的完整皮肤名称
float	number	计算出的输出磨损值
wear	string	磨损等级：Factory New等
price	number	当前市场价格（USD），无数据时为0
price_available	boolean	是否有该皮肤的价格数据
probability	number	获得该特定输出皮肤的概率（在所有有效输出中均匀分布）

错误处理

所有错误会返回一个统一格式的对象，包含error.code和error.message。常见错误码包括：

• INVALID_STEAMID (400)：steamid格式无效。
• INVENTORY_EMPTY_OR_PRIVATE (404)：未找到可交易物品或库存未公开。
• INVALID_ITEM_FORMAT (400)：请求中的物品缺少market_hash_name。
• NO_SESSION_FOUND (404)：会话过期或未先调用GET /tradeups/{steamid}。
• INTERNAL_ERROR (500)：服务器内部错误。

数据来源与可靠性

• 定价数据：价格数据通过ByMykel维护的Counter-Strike Price Tracker定期更新。数据仅供信息参考，不可作为绝对财务依据。
• Steam速率限制：Steam API有其自身的速率限制。对于高流量使用，建议优先使用POST /tradeups端点以减轻对Steam服务的直接压力。
• 非隶属关系：此项目为独立项目，与Valve公司或Steam无关。

速率限制

• 免费计划：每月50次请求，每分钟5次。
• 专业计划 (PRO)：每月20,000次请求，每分钟15次。
• 超级计划 (ULTRA)：每月50,000次请求，每分钟25次。
• 超级计划 (MEGA)：每月150,000次请求，每分钟30次。

认证

所有请求需要在请求头中提供RapidAPI密钥：

X-RapidAPI-Key: YOUR_KEY X-RapidAPI-Host: cs2-tradeup-calculator.p.rapidapi.com