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）。
参数
marketHashNamestring必填
路径段。URL 编码的 market_hash_name。marketsstring可选
查询参数。市场过滤 CSV（可重复传递），例如 csfloat,buff163。响应字段
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[]
输入数据单薄/波动大时的标志（稳定时为空数组）。跨市场最优在售价。
跨市场最优求购价。
spread_bpsintegernullable
价差，以基点计。market_countinteger
参与的市场数。fresh_market_countinteger
其中仍新鲜的市场数。listing_countinteger
支撑该读数的挂单数。buy_order_countinteger
不同求购档位数。total_bid_quantityinteger
求购数量合计。calculated_atstring (date-time)
计算时间。嵌套与共享结构链接到 API 对象 参考页。
错误
404饰品不存在。
401缺少
Authorization 头、认证方案不支持，或密钥未知、未激活、已过期、已吊销。403密钥有效，但订阅未激活/已过期，或套餐不含此接口。
429超出速率限制；见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算，所有密钥共享。
5xx上游快照不可用或服务端问题。请退避后重试。
使用此端点的指南（英文）
export SKINPRICER_API_KEY="sp_live_•••"
curl "https://pricing.skinpricer.com/v1/recommendations/AK-47%20%7C%20Redline%20(Field-Tested)" \
-H "Authorization: ApiKey $SKINPRICER_API_KEY"// npm i @skinpricer/sdk
import { SkinpricerClient, formatUsd } from "@skinpricer/sdk";
const client = new SkinpricerClient({
apiKey: process.env.SKINPRICER_API_KEY!,
authScheme: "ApiKey",
});
const rec = await client.recommendations.get("AK-47 | Redline (Field-Tested)");
console.log(rec.strategy, rec.suggested_price === null ? "withheld" : formatUsd(rec.suggested_price));import os
import requests
res = requests.get(
"https://pricing.skinpricer.com/v1/recommendations/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
{
"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"
}响应头
X-RateLimit-Limit: <每分钟配额，由套餐决定>
X-RateLimit-Remaining: <本分钟剩余次数>
X-RateLimit-Reset: <距重置的秒数>
X-RateLimit-Remaining-Month: <本月剩余次数，仅限有月度上限的套餐>
X-Request-ID: req_xxxxxxxxxxxxxxxx