BUFF sale history is now available - POST /v1/archive/buff returns sale prices and daily total supply since September 2024.
cs2.sh

GET /v1/prices/latest

本页内容

这是我们的主要最新价格端点！返回 BUFF、Youpin、CSFloat、Skinport、Steam 和 C5Game 中所有饰品的最新价格。

所有市场均支持 Doppler、Gamma Doppler 和 Case Hardened 变体。几乎所有价格约每 5 分钟（或更短）更新一次，具体取决于市场。每个来源对象都有自己的 updated_at 和 collected_at 时间戳。

访问#

适用于所有套餐。

支持的来源#

来源字段
buffask, bid, ask_volume, bid_volume
youpinask, bid, ask_volume, bid_volume
csfloatask, bid, ask_volume
skinportask, ask_volume, max_ask, mean_ask, median_ask, 24h_history, 7d_history, 30d_history, 90d_history
steamask, bid, ask_volume, bid_volume
c5gameask, bid, ask_volume

具有 Doppler、Gamma Doppler 或 Case Hardened 价格的饰品可以包含 variants；见变体。

查询参数#

参数描述
sources要返回的来源，以逗号分隔，例如 ?sources=buff,youpin。默认全部来源。
currency所有价格使用的货币，例如 ?currency=CNY。默认为 USD；见货币。

请求#

GETapi.cs2.sh/v1/prices/latest
curl https://api.cs2.sh/v1/prices/latest \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

响应#

{
  "response_time": "2026-08-23T21:59:56.831728619Z",
  "currency": "USD",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "buff": {
        "updated_at": "2026-08-23T21:56:49Z",
        "collected_at": "2026-08-23T21:59:10.862Z",
        "ask": 101.95,
        "ask_volume": 491,
        "bid": 97.46,
        "bid_volume": 50
      },
      "youpin": {
        "updated_at": "2026-08-23T21:58:45.755Z",
        "collected_at": "2026-08-23T21:59:14.764Z",
        "ask": 98.5,
        "ask_volume": 510,
        "bid": 97.01,
        "bid_volume": 67
      },
      "csfloat": {
        "updated_at": "2026-08-23T21:59:27.65Z",
        "collected_at": "2026-08-23T21:59:27.697Z",
        "ask": 95,
        "ask_volume": 241,
        "bid": 92.6
      },
      "skinport": {
        "updated_at": "2026-08-23T21:59:10.493Z",
        "collected_at": "2026-08-23T21:59:18.889Z",
        "ask": 105.55,
        "ask_volume": 61,
        "max_ask": 590.65,
        "mean_ask": 166.33,
        "median_ask": 142.99,
        "24h_history": {
          "price": 105.06,
          "max_price": 127.24,
          "mean_price": 116.15,
          "median_price": 116.15,
          "volume": 2
        },
        "7d_history": {
          "price": 100.34,
          "max_price": 317.2,
          "mean_price": 127.22,
          "median_price": 105.84,
          "volume": 11
        },
        "30d_history": {
          "price": 100.34,
          "max_price": 317.2,
          "mean_price": 121.88,
          "median_price": 111.06,
          "volume": 36
        },
        "90d_history": {
          "price": 99.22,
          "max_price": 317.2,
          "mean_price": 121.33,
          "median_price": 117.56,
          "volume": 144
        }
      },
      "steam": {
        "updated_at": "2026-08-23T21:56:50.48Z",
        "collected_at": "2026-08-23T21:57:48.359Z",
        "ask": 144.99,
        "ask_volume": 75,
        "bid": 143.09,
        "bid_volume": 2537
      },
      "c5game": {
        "updated_at": "2026-08-23T21:59:19.245Z",
        "collected_at": "2026-08-23T21:59:20.273Z",
        "ask": 102.41,
        "ask_volume": 213,
        "bid": 173.93
      }
    }
  }
}

响应字段#

LatestPricesGetResponse 字段:

字段类型必需描述
response_timestring (date-time)是响应生成时间。
currencystring是响应中所有价格的货币代码：即请求的 currency，默认为 USD。
itemsRecord<string, Item>是market_hash_name 到饰品价格数据的映射。

饰品数据#

字段描述
items.<name>.<source>该市场上最新的 ask/bid 价格与成交量，附带 updated_at 和 collected_at。
items.<name>.variantsDoppler 和 Case Hardened 变体的相同来源结构。
  • 基础饰品的来源对象是密集的：一旦任一来源对该饰品有数据，buff、youpin、csfloat、skinport、steam 和 c5game 即会出现。
  • 不可用的来源字段为 null。
  • 变体来源对象是稀疏的，仅在该来源有变体数据时出现。
  • 使用 sources 时，仅返回所选来源，在这些来源中没有数据的饰品会被省略。

完整结构：Item、Variant、SkinportPriceWindow，以及 最新价格来源数据 下的各来源类型。

错误#

400 validation_error 表示存在未知或重复的查询参数、无效的来源或不支持的货币。503 service_unavailable 表示最新快照尚未就绪。所有端点共有的错误见请求错误。

POST /v1/prices/latest#

返回与 GET /v1/prices/latest 相同的最新价格数据，但仅包含最多 100 个指定饰品。sources 和 currency 的用法与 GET 相同，放在 JSON 请求体中发送。

大多数价格约每 5 分钟更新一次，具体取决于市场。具有 Doppler、Gamma Doppler 或 Case Hardened 价格的饰品可以包含 variants。

请求#

POSTapi.cs2.sh/v1/prices/latest
curl -X POST https://api.cs2.sh/v1/prices/latest \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    "USP-S | Printstream (Factory New)",
    "★ Karambit | Doppler (Factory New)"
  ],
  "sources": [
    "buff",
    "youpin",
    "csfloat"
  ],
  "currency": "USD"
}'

参数#

字段类型必需描述
itemsstring[]是market_hash_name 值列表（最多 100 个）。
sourcesstring[]否仅返回这些来源。默认全部来源。
currencystring否默认值: USD. 允许值: AUD, CAD, CHF, CNY, EUR, GBP, JPY, NZD, SGD, USD. 响应中所有价格使用的货币。

响应#

{
  "response_time": "2026-09-22T23:22:27.021330934Z",
  "currency": "USD",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "buff": {
        "updated_at": "2026-09-22T23:18:50Z",
        "collected_at": "2026-09-22T23:21:09.233Z",
        "ask": 90.71,
        "ask_volume": 387,
        "bid": 90.12,
        "bid_volume": 43
      },
      "youpin": {
        "updated_at": "2026-09-22T23:19:34.492Z",
        "collected_at": "2026-09-22T23:19:59.576Z",
        "ask": 93.84,
        "ask_volume": 479,
        "bid": 92.2,
        "bid_volume": 46
      },
      "csfloat": {
        "updated_at": "2026-09-22T23:21:18.723Z",
        "collected_at": "2026-09-22T23:21:18.77Z",
        "ask": 93.1,
        "ask_volume": 239,
        "bid": 89
      }
    },
    "★ Karambit | Doppler (Factory New)": {
      "market_hash_name": "★ Karambit | Doppler (Factory New)",
      "buff": {
        "updated_at": "2026-09-22T23:18:28Z",
        "collected_at": "2026-09-22T23:21:09.233Z",
        "ask": 1226.38,
        "ask_volume": 1487,
        "bid": 1191.63,
        "bid_volume": 66
      },
      "youpin": {
        "updated_at": "2026-09-22T23:20:33.469Z",
        "collected_at": "2026-09-22T23:20:49.558Z",
        "ask": 1210.32,
        "ask_volume": 1725,
        "bid": 1188.65,
        "bid_volume": 25
      },
      "csfloat": {
        "updated_at": "2026-09-22T23:21:18.723Z",
        "collected_at": "2026-09-22T23:21:18.77Z",
        "ask": 1213.55,
        "ask_volume": 1059,
        "bid": 1160
      },
      "variants": {
        "Phase 2": {
          "market_hash_name": "★ Karambit | Doppler (Factory New)",
          "name": "★ Karambit | Doppler (Factory New) | Phase 2",
          "display_name": "Phase 2",
          "version": "p2",
          "buff": {
            "updated_at": "2026-09-22T23:18:28Z",
            "collected_at": "2026-09-22T23:21:09.233Z",
            "ask": 1765.03,
            "ask_volume": null,
            "bid": 1689.13,
            "bid_volume": null
          },
          "youpin": {
            "updated_at": "2026-09-22T23:20:10.56Z",
            "collected_at": "2026-09-22T23:20:30.874Z",
            "ask": 1759.08,
            "ask_volume": null,
            "bid": 1717.43,
            "bid_volume": 39
          },
          "csfloat": {
            "updated_at": "2026-09-22T23:19:09.13Z",
            "collected_at": "2026-09-22T23:19:26.276Z",
            "ask": 1750,
            "ask_volume": null,
            "bid": 1700
          }
        },
        "Ruby": {
          "market_hash_name": "★ Karambit | Doppler (Factory New)",
          "name": "★ Karambit | Doppler (Factory New) | Ruby",
          "display_name": "Ruby",
          "version": "ruby",
          "buff": {
            "updated_at": "2026-09-22T23:18:28Z",
            "collected_at": "2026-09-22T23:21:09.233Z",
            "ask": 7497.5,
            "ask_volume": null,
            "bid": 5660.24,
            "bid_volume": null
          },
          "youpin": {
            "updated_at": "2026-09-22T23:21:04.858Z",
            "collected_at": "2026-09-22T23:21:30.542Z",
            "ask": 7409.35,
            "ask_volume": null,
            "bid": 7152.75,
            "bid_volume": 50
          },
          "csfloat": {
            "updated_at": "2026-09-22T23:21:08.307Z",
            "collected_at": "2026-09-22T23:21:30.912Z",
            "ask": 7222.22,
            "ask_volume": null,
            "bid": 7030
          }
        }
      }
    }
  }
}

响应字段#

LatestPricesPostResponse 字段:

字段类型必需描述
response_timestring (date-time)是响应生成时间。
currencystring是响应中所有价格的货币代码：即请求的 currency，默认为 USD。
itemsRecord<string, Item>是market_hash_name 到饰品价格数据的映射，过滤到请求的饰品。
errorsItemError[]否与成功结果一起返回的逐饰品失败（部分成功）。

错误#

404 not_found 表示请求中的有效饰品均不在最新快照中。503 service_unavailable 表示快照尚未就绪。

如果只有部分饰品失败，端点仍返回 200，其中包含成功的饰品，并为每个失败项返回一条 errors[]。饰品错误代码包括 unknown_item、invalid_format 和 not_in_cache。见部分成功和请求错误。