GET/v1/recommendations/:marketHashNameDEVELOPER+

定价建议

饰品的建议上架/出售价格，附策略、置信度、流动性评分及支撑判断的 NBBO 上下文。响应为 snake_case。价格为整数美分。

给定一件饰品，本接口返回单一的 suggested_price（建议上架/出售价），以及背后的推理：所用 strategy、confidence 与 liquidity_score（均为 0 到 1），和推导所依据的 NBBO 上下文。

留意 unstable_reasons：非空时说明输入数据单薄或波动大、建议价置信度较低，应向用户呈现这一点，而不是把每个数字都当作同样可靠。当没有可定价的数据时，strategy 为 no_data、suggested_price 返回 null——请处理这种情况，不要假设数字总是存在。注意本响应为 snake_case（多数价格接口是 camelCase）。

Parameters

marketHashNamestringrequired

路径段。URL 编码的 market_hash_name。

marketsstringoptional

查询参数。市场过滤 CSV（可重复传递），例如 csfloat,buff163。

Response fields

RecommendationResponse建议上架/出售价格及其支撑上下文。snake_case。

canonical_item_idstring

规范饰品 id。

market_hash_namestring

Market hash name。

suggested_priceintegernullable

建议价格，单位美分。没有可定价数据时为 null（strategy: "no_data"）。

strategystring

推导方式，例如 midpoint；无可用报价时为 no_data（此时 suggested_price 为 null）。

confidencenumber

对建议价的 0 到 1 置信度。

liquidity_scorenumber

该饰品的 0 到 1 流动性评分。

unstable_reasonsstring[]

输入数据单薄/波动大时的标志（稳定时为空数组）。

best_askQuoteSnakenullable

跨市场最优在售价。

best_bidQuoteSnakenullable

跨市场最优求购价。

spread_bpsintegernullable

价差，以基点计。

market_countinteger

参与的市场数。

fresh_market_countinteger

其中仍新鲜的市场数。

listing_countinteger

支撑该读数的挂单数。

buy_order_countinteger

不同求购档位数。

total_bid_quantityinteger

求购数量合计。

calculated_atstring (date-time)

计算时间。

嵌套与共享结构链接到 API Objects 参考页（英文）。

Response 200

{
  "canonical_item_id": "cmlofca920lka01yozajhixt3",
  "market_hash_name": "Glock-18 | Water Elemental (Factory New)",
  "suggested_price": 6470,
  "strategy": "midpoint",
  "confidence": 0.96,
  "liquidity_score": 0.98,
  "unstable_reasons": [],
  "best_ask": {
    "market": "csfloat",
    "price": 6500,
    "updated_at": "2026-06-23T21:52:27.427Z",
    "is_stale": false
  },
  "best_bid": {
    "market": "buff163",
    "price": 6440,
    "updated_at": "2026-06-23T21:59:48.717Z",
    "is_stale": false
  },
  "spread_bps": 93,
  "market_count": 10,
  "fresh_market_count": 9,
  "listing_count": 710,
  "buy_order_count": 88,
  "total_bid_quantity": 128,
  "calculated_at": "2026-06-23T22:07:15.477Z"
}

Errors

404饰品不存在。

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

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

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