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

GET /v1/market/csfloat/orderbook/latest

本页内容

返回每个饰品当前的 CSFloat 求购订单。包括价格、数量和条件，例如磨损区间、paint index、已贴印花、已挂挂件/keychain 字段、挂件图案和 paint seed。

订单簿每 ~10-30 分钟更新一次，具体取决于饰品流动性，流动性越高刷新越快。

访问#

需要 Scale 或 Enterprise API 密钥。

请求#

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

响应#

{
  "response_time": "2026-08-23T21:59:41.701806658Z",
  "currency": "USD",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "updated_at": "2026-08-23T21:54:42.008Z",
      "collected_at": "2026-08-23T21:55:35.051Z",
      "top_generic_bid": 92.6,
      "orders": [
        {
          "price": 93.3,
          "quantity": 1,
          "kind": "float",
          "conditions": {
            "min_float": 0,
            "max_float": 0.04
          }
        },
        {
          "price": 93.2,
          "quantity": 1,
          "kind": "float",
          "conditions": {
            "min_float": 0,
            "max_float": 0.04
          }
        },
        {
          "price": 92.6,
          "quantity": 1,
          "kind": "float",
          "conditions": {
            "min_float": 0.03,
            "max_float": 0.04
          }
        }
      ]
    },
    "★ Karambit | Doppler (Factory New)": {
      "market_hash_name": "★ Karambit | Doppler (Factory New)",
      "updated_at": "2026-08-23T21:54:42.871Z",
      "collected_at": "2026-08-23T21:55:35.051Z",
      "top_generic_bid": null,
      "orders": [
        {
          "price": 6800,
          "quantity": 1,
          "kind": "paint_index",
          "conditions": {
            "paint_index": 415
          }
        },
        {
          "price": 6790,
          "quantity": 1,
          "kind": "paint_index",
          "conditions": {
            "paint_index": 415
          }
        }
      ],
      "variants": {
        "Phase 2": {
          "market_hash_name": "★ Karambit | Doppler (Factory New)",
          "name": "★ Karambit | Doppler (Factory New) | Phase 2",
          "display_name": "Phase 2",
          "version": "p2",
          "updated_at": "2026-08-23T21:57:12.655Z",
          "collected_at": "2026-08-23T21:57:35.153Z",
          "top_generic_bid": 1190,
          "orders": [
            {
              "price": 1650,
              "quantity": 1,
              "kind": "paint_index",
              "conditions": {
                "paint_index": 419
              }
            },
            {
              "price": 1640,
              "quantity": 1,
              "kind": "paint_index",
              "conditions": {
                "paint_index": 419
              }
            }
          ]
        },
        "Ruby": {
          "market_hash_name": "★ Karambit | Doppler (Factory New)",
          "name": "★ Karambit | Doppler (Factory New) | Ruby",
          "display_name": "Ruby",
          "version": "ruby",
          "updated_at": "2026-08-23T21:10:37.529Z",
          "collected_at": "2026-08-23T21:11:32.943Z",
          "top_generic_bid": 1190,
          "orders": [
            {
              "price": 6800,
              "quantity": 1,
              "kind": "paint_index",
              "conditions": {
                "paint_index": 415
              }
            },
            {
              "price": 6790,
              "quantity": 1,
              "kind": "paint_index",
              "conditions": {
                "paint_index": 415
              }
            }
          ]
        }
      }
    }
  }
}

响应字段#

CSFloatBuyOrdersLatestResponse 字段:

字段类型必需描述
response_timestring (date-time)是生成此快照响应的时间。
currencystring是货币代码（始终为 USD）。
itemsRecord<string, CSFloatBuyOrdersItem>是具有当前求购订单簿的饰品，以 market_hash_name 为键。

订单簿数据#

字段描述
items.<name>.orders求购订单阶梯，按价格降序。每个订单都有 kind 和一个 conditions 对象（generic 订单为 {}）。
items.<name>.top_generic_bid无条件订单中的最高价格；仅存在条件订单时为 null。
items.<name>.variantsDoppler 和 Gamma Doppler 相位订单簿，以显示名称为键。
items.<name>.updated_at、collected_atCSFloat 的更新时间与 cs2.sh 的抓取时间。
  • 空 orders 数组只会出现在已确认没有挂起求购订单的 Doppler 或 Gamma Doppler 相位上。缺失的饰品或相位订单簿表示未知或过期，不代表已确认为空。

求购订单条件#

kind含义
generic无条件。conditions 为 {}。
paint_index挂单的 paint index 必须匹配。
float挂单的磨损值必须位于给定范围内。
sticker挂单必须满足指定的印花要求。
keychain_pattern已挂挂件的图案值必须位于给定范围内。
paint_seeds挂单的 paint seed 必须是给定值之一。
keychain挂单必须具有指定挂件。
mixed挂单必须同时满足所有给定条件类别。
conditions 键类型含义
paint_indexinteger挂单的 paint index 必须等于此值。
min_floatnumber挂单的磨损值必须大于或等于此值。
max_floatnumber挂单的磨损值必须小于或等于此值。
stickersCSFloatStickerCondition[]挂单必须满足每项印花要求。同一 sId 重复出现表示要求多枚该印花。
min_keychain_patterninteger已挂挂件的图案值必须大于或等于此值。
max_keychain_patterninteger已挂挂件的图案值必须小于或等于此值。
paint_seedsinteger[]挂单的 paint seed 必须等于其中一个值。
keychainsCSFloatKeychainCondition[]挂单必须具有此数组中标识的每个挂件。

存在多个条件字段时，挂单必须全部满足。mixed 订单还可以原样包含其他 CSFloat 条件键。

印花要求：

字段类型必需含义
sIdinteger是挂单必须具有的印花的 CSFloat 数字 ID。
sinteger否必须贴有此印花的槽位，从零开始。省略时，该印花可位于任意槽位。

挂件要求：

字段类型必需含义
sIdinteger是挂单必须具有的挂件的 CSFloat 数字 ID。

完整结构：CSFloatBuyOrdersItem、CSFloatBuyOrdersVariant、CSFloatBuyOrder、CSFloatBuyOrderConditions、CSFloatStickerCondition、CSFloatKeychainCondition。

错误#

503 service_unavailable 表示最新订单簿快照缺失、过期或为空。共享错误见请求错误。