GET/v1/liquidity/summary/:marketHashNamePRO+

流动性摘要

流动性模型的精简徽章投影：liquidityBadge、小写的 liquidity 标签、便于阅读的 estimatedSaleTime、confidence，以及 0 到 100 的 score。为快速查询与徽章展示而设计。价格为整数美分。

与流动性相同的跨市场模型，投影为便于做徽章的精简结构：liquidityBadge、小写的 liquidity 标签、便于阅读的 estimatedSaleTime，以及 0 到 100 的 score（无成交时为 null）。适合列表徽章和快速查询这类用不上完整拆分的场景。

参数

marketHashNamestring必填

路径段。URL 编码的 market_hash_name。

askPriceinteger可选

查询参数。用于估算的假设在售价（美分）。默认使用当前最优在售价。

marketstring可选

查询参数。限定为单个市场：skinport | marketcsgo | dmarket | csfloat | steamcommunity。

响应字段

LiquiditySummary饰品的精简流动性徽章视图。

marketHashNamestring

Market hash name。

liquidityBadgestring

liquiditystring

小写标签；INSUFFICIENT_DATA（以及旧值 UNTRADED）映射为 unknown。

estimatedSaleTimestring

便于阅读的售出时间，例如 2 - 6 hours。

confidencestring

HIGH | MEDIUM | LOW | CRITICAL。

scoreintegernullable

0 到 100（越高卖得越快）；无成交时为 null。

bestMarketToListstringnullable

预计售出时间最短的市场。

calculatedAtstring (date-time)

计算时间。

错误

404饰品不存在。

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/summary/AK-47%20%7C%20Redline%20(Field-Tested)" \
  -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 s = await client.liquidity.summary("AK-47 | Redline (Field-Tested)");
console.log(s.liquidityBadge, s.estimatedSaleTime);

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/liquidity/summary/AK-47%20%7C%20Redline%20(Field-Tested)",
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

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

响应 200

{
  "marketHashName": "Glock-18 | Water Elemental (Factory New)",
  "liquidityBadge": "VERY_ILLIQUID",
  "liquidity": "very_illiquid",
  "estimatedSaleTime": "10 - 14 days",
  "confidence": "LOW",
  "score": 22,
  "bestMarketToList": "csfloat",
  "calculatedAt": "2026-06-23T22:07:17.129Z"
}

响应头

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

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

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

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

X-Request-ID: req_xxxxxxxxxxxxxxxx