GET/v1/liquidity/itemsENTERPRISE

批量流动性映射

Enterprise：全目录流动性映射，从 market_hash_name 映射到徽章、小写标签、预计售出时间、评分与最佳市场，每 10 分钟重新生成一次。携带上一个 version 发送 If-None-Match 可获得 304；首个快照生成之前返回 503。每件饰品是一个 LiquidityBulkItem。

Enterprise：全目录流动性映射，每 10 分钟重建一次。items 以 market_hash_name 为键，每个值是一个 LiquidityBulkItem。发送 If-None-Match: "<version>" 可在无变化时获得 304；首个快照生成之前会返回 503（附 Retry-After）。先轮询低成本的清单，再决定是否重新拉取。

参数

If-None-Matchstring可选

请求头。你持有的上一个 version（ETag）；快照未变化时返回 304。

响应字段

LiquidityBulkResponse全目录流动性映射。Enterprise。

versionstring

不透明的快照版本，形如 <ms>-<pid>（生成时的毫秒时间 + worker pid）。只用于判断是否相等。它同时也是 ETag；不要解析它。

calculatedAtstring (date-time)

快照生成时间。

cadencestring

重算周期（ISO-8601 时长），例如 PT10M。

marketsstring[]

覆盖的市场。

itemCountinteger

快照中的饰品数。

itemsobject

market_hash_name 到 LiquidityBulkItem 的映射。

嵌套与共享结构链接到 API 对象参考页。

错误

503快照尚未生成；请在 Retry-After 指定的时间后重试。

401缺少 Authorization 头、认证方案不支持，或密钥未知、未激活、已过期、已吊销。

403密钥有效，但订阅未激活/已过期，或套餐不含此接口。

429超出速率限制；见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算，所有密钥共享。

5xx上游快照不可用或服务端问题。请退避后重试。

另见低成本变更探测单件流动性

使用此端点的指南（英文）

How to check CS2 skin liquidity and time-to-sell

export SKINPRICER_API_KEY="sp_live_•••"

curl "https://pricing.skinpricer.com/v1/liquidity/items" \
  -H "Authorization: ApiKey $SKINPRICER_API_KEY"

// npm i @skinpricer/sdk
import { SkinpricerClient } from "@skinpricer/sdk";

const client = new SkinpricerClient({
  apiKey: process.env.SKINPRICER_API_KEY!,
  authScheme: "ApiKey",
});

const snapshot = await client.liquidity.bulk();
console.log(Object.keys(snapshot.items).length, "items, version", snapshot.version);

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/liquidity/items",
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

需要认证的接口：请在你自己的客户端中携带 API 密钥调用（见代码示例）。

响应 200

{
  "version": "1782294002802-1",
  "calculatedAt": "2026-06-24T09:40:02.802Z",
  "cadence": "PT10M",
  "markets": [
    "skinport",
    "marketcsgo",
    "dmarket",
    "csfloat",
    "steamcommunity"
  ],
  "itemCount": 35349,
  "items": {
    "Glock-18 | Water Elemental (Factory New)": {
      "market_hash_name": "Glock-18 | Water Elemental (Factory New)",
      "liquidity": "illiquid",
      "estimated_sale_time": "4 - 5 days",
      "liquidityBadge": "ILLIQUID",
      "confidence": "HIGH",
      "score": 33,
      "bestMarketToList": "skinport",
      "variants": {}
    }
  }
}

响应头

X-RateLimit-Limit: <每分钟配额，由套餐决定>

X-RateLimit-Remaining: <本分钟剩余次数>

X-RateLimit-Reset: <距重置的秒数>

X-RateLimit-Remaining-Month: <本月剩余次数，仅限有月度上限的套餐>

X-Request-ID: req_xxxxxxxxxxxxxxxx