Skip to main content
GET/v1/liquidity/summary/:marketHashNamePRO+

Liquidity Summary

A slim, badge-only projection of the liquidity model: a liquidityBadge, a lowercase liquidity label, a human estimatedSaleTime, confidence, and a 0–100 score. Built for quick lookups and badges. Prices are integer USD cents.

The same cross-market model as liquidity, projected to a slim badge-friendly shape: a liquidityBadge, a lowercase liquidity label, a human estimatedSaleTime, and a 0–100 score (null when untraded). Use it for list badges and quick lookups where the full breakdown is overkill.

Parameters

marketHashNamestringrequired
Path segment. URL-encoded market_hash_name.
askPriceintegeroptional
Query. Hypothetical ask price in USD cents to estimate against. Defaults to the current best ask.
marketstringoptional
Query. Restrict to one market: skinport | marketcsgo | dmarket | csdeals | csfloat.

Response fields

LiquiditySummarySlim liquidity badge view for an item.
marketHashNamestring
Market hash name.
liquidityBadgestring
EXTREMELY_LIQUIDUNTRADED (7-value scale).
liquiditystring
Lowercase label (cs2.sh-compatible); UNTRADED maps to unknown.
estimatedSaleTimestring
Human time-to-sell, e.g. 2 - 6 hours.
confidencestring
HIGH | MEDIUM | LOW | CRITICAL.
scoreintegernullable
0–100 (higher = sells faster); null when untraded.
bestMarketToListstringnullable
Market with the lowest expected time-to-sell.
calculatedAtstring (date-time)
When it was computed.

Response 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"
}

Errors

404Item not found.
401 / 403Missing, invalid, or insufficient-plan API key.
429Rate limit exceeded; see Retry-After + X-RateLimit-* headers.
5xxUpstream snapshot unavailable or a server-side issue. Retry with backoff.
curl "https://pricing.skinpricer.com/v1/liquidity/summary/:marketHashName" \
  -H "Authorization: ApiKey sk_live_•••••••••••"

Authenticated endpoint — call it with your API key from your own client (see the code sample).

Response headers
X-RateLimit-Limit: <per-minute, set by your plan>
X-RateLimit-Remaining: <remaining this minute>
X-RateLimit-Reset: <seconds to reset>
X-Request-ID: req_xxxxxxxxxxxxxxxx

Usage & licensing

Access to the API and its data is governed by our Terms of Service. You may not resell or redistribute the data, use it to build a competing service, or exceed your plan’s rate limits, and you must attribute SkinPricer as the source wherever the Terms permit you to display it. Abuse may be throttled or suspended.