Skip to main content

API 对象

API 返回的每个对象在此各文档化一次。接口页面展示其顶层响应结构,嵌套与共享对象链接到这里,因此每个数据结构只在一处维护。

SchemaSnapshot完整目录快照。以预序列化形式返回并带 ETag;目录真正变化之前,返回的字节完全相同。
schemaVersioninteger
最近一次内容变更的单调递增版本号(毫秒时间戳)。请保存它并传给 changes?since=。
generatedAtstring (date-time)
快照生成时间。
itemCountinteger
快照中的饰品数。
所有稀有度等级,由饰品级的 rarity 键引用。
collectionsobject
收藏品名称到 SchemaCollection 的映射。
containersobject
容器名称到 SchemaContainer 的映射。
itemsobject
market_hash_name 到 SchemaItem 的映射。
SchemaItem一条目录记录。稀疏:不适用于该饰品的字段会被完全省略,绝不为 null。
idstring
规范饰品 id;与价格、NBBO 和流动性接口返回的 id 相同,因此 schema 与价格可以直接关联。
marketHashNamestring
规范的 Steam market hash name(与价格类接口一致)。
slugstring
URL 安全的标识符。
categorystring
skin | glove | sticker | agent | charm | patch | graffiti | music_kit | collectible | container | key。
baseNamestringnullable
不含外观后缀的饰品名称。仅限皮肤 / 手套。
weaponstringnullable
武器名称。仅限皮肤。
finishstringnullable
涂装名称。仅限皮肤 / 手套。
paintIndexstringnullable
游戏内涂装索引。仅限皮肤 / 手套。
raritystringnullable
rarities 注册表中的键。
wearstringnullable
该行的外观,例如 Field-Tested。仅限带磨损的饰品。
wearsstring[]nullable
该基础饰品存在的所有外观。
stattrakbooleannullable
该行是否为 StatTrak 版本。
souvenirbooleannullable
该行是否为纪念品版本。
hasStattrakbooleannullable
是否存在对应的 StatTrak 版本。
hasSouvenirbooleannullable
是否存在对应的纪念品版本。
stattrakOfstringnullable
在 StatTrak 行上:对应的普通(非 StatTrak)版本的 market_hash_name。与 variant 反向链接的方向一致。
souvenirOfstringnullable
在纪念品行上:对应的普通版本的 market_hash_name。
floatRangeobjectnullable
{ min, max } 磨损区间。仅限带磨损的饰品。
variantsSchemaVariant[]nullable
该基础饰品下的多普勒 / 伽马多普勒相位行。
variantobjectnullable
相位行指向其基础饰品的反向链接:{ base, family, name }。
collectionsstring[]nullable
收藏品名称;即 collections 注册表中的键。
containersstring[]nullable
掉落该饰品的容器;即 containers 注册表中的键。
imagestringnullable
图片 URL。
releaseDatestring (date-time)nullable
发布日期。仅限容器,且已知时提供。
idsobject
市场 id 到该交易市场自身目录 id 的映射,覆盖所有已接入的市场。
aliasesobjectnullable
市场 id 到该交易市场挂单标题的映射,仅在与 marketHashName 不同时出现。
SchemaVariant列在基础饰品 variants 下的一个多普勒 / 伽马多普勒相位。
marketHashNamestring
相位的完整 market_hash_name(它有自己的 SchemaItem 行,可直接定价)。
familystring
doppler | gamma_doppler。
namestring
相位名称,例如 Phase 2、Ruby、Emerald。
phaseintegernullable
数字相位(1 到 4)。宝石相位省略。
imagestringnullable
相位图片 URL。
SchemaRarity一个稀有度等级,由饰品级的 rarity 键引用。
keystring
稳定的稀有度键,例如 classified。
namestring
显示名称,例如 Classified。
tierinteger
数字等级,随稀有度升高而增大。
colorstringnullable
该稀有度的十六进制颜色。
SchemaCollection收藏品元数据,在 collections 注册表中以名称为键。
namestring
收藏品名称。
imagestringnullable
图片 URL(如有)。
SchemaContainer容器元数据,在 containers 注册表中以名称为键。
namestring
容器名称。
typestring
容器类型,例如 case。
releaseDatestring (date-time)nullable
发布日期(已知时提供)。
imagestringnullable
图片 URL(如有)。
SchemaItemLookup单件饰品,只附带它所引用的注册表条目。
schemaVersioninteger
该饰品最近一次变更时的版本号(毫秒时间戳)。
该饰品的目录记录。
registriesobjectnullable
{ rarities, collections, containers },只包含该饰品引用的条目。
SchemaChanges在 since 之后新增或变更的饰品,按键集分页。
schemaVersioninteger
当前全目录版本号。请保存为下一次的 since。
sinceinteger
解析后的 since 位置(毫秒时间戳)。
countinteger
本页的饰品数。
hasMoreboolean
是否还有下一页。
nextCursorstringnullable
作为 cursor 传回以获取下一页。
变更的饰品,完整记录。
registriesobjectnullable
返回饰品所引用的注册表条目;没有变化时省略。
NbboResponse单件饰品在所有已接入市场上的最优求购价 + 最优在售价。
marketHashNamestring
饰品的 Steam market hash name。
canonicalItemIdstring
SkinPricer 的规范饰品 id。
bestAskQuotenullable
全市场最低在售价。无新鲜在售价时为 null。
bestBidQuotenullable
全市场最高求购价。默认(全市场)视图下仅统计可现金变现的市场,见下方 bestBid 说明。没有符合条件的求购价时为 null。
spreadBpsintegernullable
bestAsk − bestBid,以基点计。缺少任一边时为 null;超过 10000 基点(±100% 价差,几乎总是过期/异常求购价)时也被置为 null。负(交叉)价差会保留。
marketCountinteger
提供报价的市场数。
freshMarketCountinteger
其中仍新鲜的市场数。
lockedboolean
bestBid == bestAsk(零价差)时为 true。
crossedboolean
bestBid 扣除卖方平台预估佣金后仍高于 bestAsk(短暂倒挂)时为 true。仅在扣费前更高的求购价不会触发。
confidencenumber
由覆盖度、新鲜度与一致性得出的 0 到 1 置信度。
executionAdjustedExecutionAdjustedNbbonullable
扣费并按可执行性折价后的"真实最优市场"(SP-261)。无法计算时为 null。详见专属对象。
calculatedAtstring (date-time)
本次 NBBO 的计算时间。
Quote单个市场的求购价或在售价。
marketstring
提供该报价的市场 id,例如 csfloat。
priceinteger
报价,单位美分。
updatedAtstring (date-time)
来源报价的最后更新时间。
isStaleboolean
报价超出新鲜度窗口(全市场统一的 30 分钟阈值)时为 true。
ExecutionAdjustedNbbo执行调整后的 NBBO:对每个平台应用手续费与可执行性折价后的最优在售价/最优求购价,比较的是实际支付与实际净收,而非标价。响应上可为 null(无法计算时)。价格为美分。
bestAskExecutionAdjustedQuotenullable
扣费后的最优在售价(买家实付总额)。无符合条件者时为 null。
bestBidExecutionAdjustedQuotenullable
扣费后的最优求购价(卖家扣除佣金 + 提现费后的净收)。无符合条件者时为 null。
spreadBpsintegernullable
调整后的 bestAsk − bestBid,以基点计。与原始 spreadBps 不同,不做裁剪,可能为负。
lockedboolean
调整后求购价 == 调整后在售价时为 true。
crossedboolean
调整后求购价 > 调整后在售价时为 true。
executableConfidencenumber
对调整后读数的 0 到 1 置信度(可执行性 + 新鲜度)。
reasonsstring[]
该配对的顶层调整标志,例如 assumed_fees。
feeModelVersionstring
计算调整所用手续费模型的版本。
calculatedAtstring (date-time)
调整后 NBBO 的计算时间。
ExecutionAdjustedQuote执行调整后 NBBO 的一边。价格为美分。
marketstring
市场 id。
priceinteger
扣费后价格:在售侧为实付总额,求购侧为净收。
rawPriceinteger
未调整价格(仅做汇率换算),扣费前。
appliedFeeBpsinteger
应用的手续费(基点):在售侧为买家费率,求购侧为卖家佣金。
withdrawalFlatUsdCentsintegernullable
固定提现/出金费(美分,求购侧;不适用时缺席)。
executabilitynumber
0 到 1 乘数(新鲜度 × 深度 × 延迟,求购侧另计求购单持续性)。
updatedAtstring (date-time)
来源报价的最后更新时间。
isStaleboolean
来源报价是否过期。
reasonsstring[]
该腿的调整标志,例如 thin_executable_depth、high_ingest_latency、stale_fallback、low_bid_persistence。
PricingResponse完整跨市场快照:各市场报价 + 聚合值。
canonicalItemIdstring
SkinPricer 的规范饰品 id。
namestring
饰品的 market hash name。
aggregateAggregatenullable
所有参与市场的汇总统计。当饰品没有任何有价市场时(例如饰品搜索的部分行)可为 null/缺席。
每个有实时在售价的市场一条。
buyOrdersBuyOrder[]
各市场的有效求购单。
bestAskQuotenullable
跨市场最优在售价。
bestBidQuotenullable
最优求购价。与 /v1/nbbo 一样,默认仅统计可现金变现的市场;传入 markets 则采信每个被请求平台的求购价。
spreadBpsintegernullable
最优在售价 − 最优求购价,以基点计。缺少任一边、盘口交叉(求购价高于在售价)或超过 10000 基点时为 null。
marketCountinteger
提供报价的市场数。
freshMarketCountinteger
其中仍新鲜的市场数。
calculatedAtstring (date-time)
快照计算时间。
Aggregate跨市场汇总统计。所有价格为美分。没有任何市场提供可用在售价时,每项统计均为 null。
minPriceintegernullable
全市场最低在售价。
maxPriceintegernullable
全市场最高在售价。
avgPriceintegernullable
在售价均值。
medianPriceintegernullable
在售价中位数。
stdDevnumbernullable
在售价标准差(浮点,不取整到美分)。
marketCountinteger
纳入统计的市场数。
freshMarketCountinteger
其中仍新鲜的市场数。
listingCountinteger
聚合背后的挂单总数。
updatedAtstring (date-time)
聚合最近一次重算的时间。
MarketQuote单个市场的代表性在售价,附摄取时间。
marketstring
市场 id。
priceinteger
在售价,单位美分。
currencystring
恒为 USD(源价格已统一换算)。
fetchedAtstring (date-time)
SkinPricer 最近一次从该市场抓取该报价的时间。
ingestedAtstring (date-time)
SkinPricer 将其写入价格存储的时间。
quoteSizeinteger
支撑该报价的挂单数。
ingestLatencyMsinteger
fetchedAt → ingestedAt 延迟,毫秒。
isStaleboolean
超出新鲜度窗口(统一 30 分钟阈值)。
sourceUpdatedAtstring (date-time)
市场自身生成该价格的时间。市场未提供时间时省略(大多数市场);见数据新鲜度。
sourceTimeKindstring
payload、last_modified、cdn_age 或 none:sourceUpdatedAt 的来源。与其一同省略。
sourceAgeSecondsinteger
SkinPricer 观测时市场数据已有多旧,单位秒。与 sourceUpdatedAt 一同省略。
isSourceStaleboolean
以 sourceUpdatedAt 判断的 isStale。尚未下发。
BuyOrder某市场的一个有效求购档位。与 markets[] 的在售报价同为 MarketPricePoint 结构(求购侧),因此携带完整摄取时间,而不只是价格 + 数量。
marketstring
市场 id。
priceinteger
求购价,单位美分。
currencystring
恒为 USD(源价格已统一换算)。
fetchedAtstring (date-time)
SkinPricer 最近一次从该市场抓取该求购单的时间。
ingestedAtstring (date-time)nullable
SkinPricer 将其写入价格存储的时间。
quoteSizeintegernullable
支撑该报价的挂单/订单数。
totalQuantityintegernullable
该价位的求购数量。
ingestLatencyMsintegernullable
fetchedAt → ingestedAt 延迟,毫秒。
isStalebooleannullable
超出该市场的新鲜度窗口。
HistoryResponse饰品按时间分桶的价格序列。
canonicalItemIdstring
规范饰品 id。
namestring
Market hash name。
listingTypestring
SELL_OFFER | BUY_ORDER | SALE_HISTORY。
salesWindowstringnullable
仅当 listingType=SALE_HISTORY 时设置。
effectiveIntervalstring
实际返回的分桶宽度:10m | 1h | 1d。可能与请求的 interval 不同,后者会对齐到这些已存储的汇总粒度。
每个时间分桶一行,从旧到新。
HistoryBucket一个时间分桶。价格为美分。
timestampstring (date-time)
分桶起始时间。
avgPriceinteger
分桶内价格均值。
medianPriceinteger
价格中位数。
minPriceinteger
最低价。
maxPriceinteger
最高价。
listingCountinteger
分桶内观察到的挂单数。
totalQuantityintegernullable
分桶内的求购数量(BUY_ORDER 时有值;其余为 null)。
volumeintegernullable
SALE_HISTORY 时为分桶内的滚动成交笔数(成交数量,非成交额);SELL_OFFER / BUY_ORDER 为 null。
bestBidCentsintegernullable
分桶内最优求购价。
bestAskCentsintegernullable
分桶内最优在售价。
spreadBpsintegernullable
分桶价差,以基点计。
PriceHistoryByMarketResponse饰品的按市场时间分桶价格序列。
canonicalItemIdstring
规范饰品 id。
namestring
Market hash name。
listingTypestring
SELL_OFFER | BUY_ORDER | SALE_HISTORY。
salesWindowstringnullable
仅当 listingType=SALE_HISTORY 时设置。
effectiveIntervalstring
实际返回的分桶宽度:10m | 1h | 1d。可能与请求的 interval 不同,后者会对齐到这些已存储的汇总粒度。
每个市场一条。
MarketSeries单个市场的历史序列。
marketstring
市场 id。
每个时间分桶一行,从旧到新。
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)
计算时间。
QuoteSnake单个市场的求购价或在售价(snake_case)。
marketstring
市场 id。
priceinteger
价格,单位美分。
updated_atstring (date-time)
来源报价的最后更新时间。
is_staleboolean
超出新鲜度窗口。
ListingsResponse逐件实时挂单,附磨损覆盖率元数据。
marketHashNamestring
Market hash name。
canonicalItemIdstring
规范饰品 id。
totalListingsinteger
在其市场最长时效内(1 小时;steamcommunity 为 6 小时)抓取的全市场挂单数。可能小于 sampledListings,甚至为 0,而过期挂单行仍会返回。
sampledListingsinteger
本次返回的挂单数(≤ limit)。
floatCoverageFloatCoverage
哪些市场对该饰品公开磨损值。
floatSummaryFloatSummarynullable
观察到的磨损值摘要;未观察到磨损时为 null。
listingsListing[]
抽样的挂单。
calculatedAtstring (date-time)
抽样时间。
FloatCoverage该饰品在各市场的磨损数据可用性。
coveragestring
complete | partial | none(样本内的磨损可用性)。
sampledListingsinteger
抽样的挂单数。
listingsWithFloatinteger
其中带磨损值的挂单数。
marketsWithFloatstring[]
本次返回样本中带已知磨损值的在售市场 id(并非所有曾公开磨损值的市场)。
marketsWithoutFloatstring[]
本次返回样本中没有已知逐件磨损值的在售市场 id。
FloatSummary观察到的磨损值与该饰品磨损区间的对照。
observednumber
返回样本中带已知磨损值的最便宜挂单的磨损值。
itemMinnumbernullable
该饰品可能的最小磨损值(已限定在其外观磨损区间内,0 到 1)。未知时为 null。
itemMaxnumbernullable
该饰品可能的最大磨损值(已限定在其外观磨损区间内,0 到 1)。未知时为 null。
observedSourceobject
提供 observed 的挂单 { market, price, fetchedAt, isStale };price 为整数美分,isStale 为该挂单的过期标志。
Listing一条独立挂单。
listingIdstringnullable
市场侧挂单 id;聚合回退行为 null。
marketstring
市场 id。
priceinteger
挂单价格,单位美分。
currencystring
恒为 USD。
floatValuenumbernullable
磨损值(截取到 [0,1]);市场不公开时为 null。
paintSeedintegernullable
模板编号(paint seed / pattern index);不可用时为 null。
paintIndexintegernullable
皮肤目录/涂装索引;市场不公开时为 null。
inspectLinkstringnullable
Steam 检视链接/检视载荷引用;不可用时为 null。
stickersSticker[]
已贴印花(没有时为空数组)。
isStatTrakboolean
该挂单是否为 StatTrak。
fetchedAtstring (date-time)
挂单抓取时间。
isStaleboolean
fetchedAt 超过 30 分钟时为 true。挂单在样本中保留的时间更长,因此过期挂单可能已超出其市场的最长时效、不再计入 NBBO。
Sticker挂单饰品上的一张已贴印花。
namestring
印花名称,例如 Sticker | device | Cologne 2016。
slotinteger
印花槽位,从 0 开始。
wearnumbernullable
印花磨损(刮花程度),0(全新)到 1(完全刮花)。市场未提供时省略(或为 null):缺失应视为未知,而不是 0,切勿显示为 0%。
DepthResponseNBBO 附近的聚合挂单深度。
marketHashNamestring
Market hash name。
canonicalItemIdstring
规范饰品 id。
depthinteger
每边请求的档位数(1 到 50)。
marketCountinteger
参与的市场数。
排序后的在售档位,最优在前。
排序后的求购档位,最优在前。
spreadBpsintegernullable
盘口价差(基点)。与 /v1/nbbo 和 /v1/pricing 不同,不做裁剪:盘口交叉时可能很大或为负。
lockedboolean
盘口求购价 == 盘口在售价。
crossedboolean
返回的深度中,存在新鲜的可现金变现求购价在扣除预估卖方佣金后仍高于新鲜的现金在售价时为 true。Steam 钱包、机器人报价、未知与过期报价无法触发,因此 spreadBps 为负时 crossed 仍可能为 false。
calculatedAtstring (date-time)
计算时间。
DepthLevel一个价格档位,含累计数量与贡献方。
rankinteger
1 = 最优。在本边内的排名。
priceinteger
档位价格,单位美分。
quantityinteger
该档位的数量。
ordersCountinteger
该档位的订单/挂单数。
marketCountinteger
贡献该档位的市场数。
cumulativeQuantityinteger
自最优档位起的累计数量。
updatedAtstring (date-time)
最近一次贡献报价的时间。
isStaleboolean
该档位是否过期。
构成该档位的各市场报价。
DepthQuote单个市场对某个深度档位的贡献。
marketstring
市场 id。
levelinteger
该市场自己的档位序号。
priceinteger
价格,单位美分。
quantityinteger
来自该市场的数量。
ordersCountinteger
来自该市场的订单数。
updatedAtstring (date-time)
报价更新时间。
isStaleboolean
是否过期。
ArbitrageResponse排序后的跨市场套利机会。
按 sort 排序(默认 estimatedNetCents)。
totalCandidatesinteger
在新鲜报价校验与查询过滤之前入围的交叉盘口候选数(通常大于 opportunities.length)。
calculatedAtstring (date-time)
响应计算时间。
ArbitrageOpportunity跨两个市场的买入腿/卖出腿配对。
canonicalItemIdstring
规范饰品 id。
marketHashNamestring
Market hash name。
slugstring
SkinPricer 饰品 slug。
imageUrlstring
饰品图片 URL。
新鲜的在售腿(你买入的地方)。
sellArbLeg
新鲜的求购腿(你卖出的地方)。
spreadBpsinteger
毛价差,以基点计。
spreadCentsinteger
毛价差,单位美分。
estimatedNetCentsinteger
扣除提现/交易手续费之前的预估净利。
maxTradableQuantityinteger
两腿都能成交的数量。
estimatedNotionalCentsinteger
买入侧预估名义金额。
feeNotesstring
针对净利估算的手续费说明。
freshnessobject
两腿报价龄期 { buyAgeMs, sellAgeMs }。
calculatedAtstring (date-time)
计算时间。
ArbLeg一条机会的一腿。
marketstring
市场 id。
priceinteger
该腿价格,单位美分。
quoteSizeinteger
该报价下可成交的数量。
updatedAtstring (date-time)
报价更新时间。
isStaleboolean
是否过期。
AttributePricesResponse受支持市场上的按属性分桶价格。
bucketSchemaVersioninteger
分桶结构的 schema 版本。
marketsstring[]
本响应覆盖的市场。
currencystring
恒为 USD。
asOfstring (date-time)
快照时间。
每个 饰品 × 市场 一条。
nextCursorstringnullable
下一页的不透明游标(作为 cursor 传回);最后一页为 null。
sourceGapsstring[]
请求了但本响应无覆盖的市场。
AttributeItem某饰品在单个市场上的分桶。
canonicalItemIdstring
规范饰品 id。
marketHashNamestring
Market hash name。
marketstring
市场 id。
磨损/渐变/图案/模板/变体区间。
AttributeBucket一个属性区间,带各自的在售价/求购价。价格为美分。
bucketIdstring
该分桶的稳定 id。
bucketKeystring
可读键,例如 float:0-0.01。
bucketTypestring
attribute | … 分桶类别。
attributeTypestring
主属性,例如 float 或 tag(相位/宝石变体)。
attributeTypesstring[]
该分桶涉及的全部属性(例如 tag 与 float)。
dimensionsobject
区间边界:{ variant, float, fade, pattern, paintSeed };每个区间为半开区间 [min, max)。variant 是相位/宝石名,如 Phase2。请以此为准读取精确边界——各市场宽度不同。
sourceItemIdstring
来源市场自己的饰品 id。
sourceBucketIdstring
来源市场自己的分桶 id(其原生区间编码)。
askCentsintegernullable
分桶内最低在售价。
avgAskCentsintegernullable
分桶内挂单在售价均值。
medianAskCentsintegernullable
分桶内挂单在售价中位数。
bidCentsintegernullable
分桶内最高求购价。
askListingCountintegernullable
在售价背后的挂单数。
bidOrderCountintegernullable
求购价背后的订单数。
sourceUpdatedAtstring (date-time)
来源的最后更新时间。
collectedAtstring (date-time)
SkinPricer 采集时间。
AttributeHistoryResponse按属性分桶价格的时间序列。
bucketSchemaVersioninteger
分桶结构的 schema 版本。
marketsstring[]
本响应覆盖的市场。
currencystring
恒为 USD。
granularitystring
点间隔,例如 10m。
每个 饰品 × 市场 一条。
sourceGapsstring[]
请求了但无覆盖的市场。
AttributeHistoryItem某饰品在单个市场上的分桶序列。
canonicalItemIdstring
规范饰品 id。
marketHashNamestring
Market hash name。
marketstring
市场 id。
每个属性区间一条序列。
AttributeHistoryBucket一个属性区间及其时间序列。
bucketIdstring
该分桶的稳定 id。
bucketKeystring
可读键,例如 float:0-0.01。
bucketTypestring
attribute | … 分桶类别。
attributeTypestring
主属性,例如 float 或 tag(相位/宝石变体)。
attributeTypesstring[]
该分桶涉及的全部属性(例如 tag 与 float)。
dimensionsobject
区间边界:{ variant, float, fade, pattern, paintSeed };每个区间为半开区间 [min, max)。variant 是相位/宝石名,如 Phase2。
sourceItemIdstring
来源市场自己的饰品 id。
sourceBucketIdstring
来源市场自己的分桶 id(其原生区间编码)。
按时间排序的价格点,从旧到新。
AttributeHistoryPoint属性区间在一个时间分桶内的买卖价。价格为美分。
bucketStartstring (date-time)
时间分桶起始。
openAskCentsintegernullable
分桶内首个在售价。
highAskCentsintegernullable
分桶内最高在售价。
lowAskCentsintegernullable
分桶内最低在售价。
closeAskCentsintegernullable
分桶内最后一个在售价。
avgAskCentsintegernullable
分桶内在售价均值。
closeBidCentsintegernullable
分桶内最后一个求购价。
askListingCountintegernullable
收盘在售价背后的挂单数。
bidOrderCountintegernullable
收盘求购价背后的订单数。
firstObservedAtstring (date-time)
分桶内首次观测时间。
lastObservedAtstring (date-time)
分桶内最后观测时间。
BuffLatestResponse仅 buff163 的饰品属性分桶价格。
bucketSchemaVersioninteger
分桶结构的 schema 版本。
marketstring
恒为 buff163。
currencystring
恒为 USD。
asOfstring (date-time)
快照时间。
每个饰品一条;分桶沿用 AttributeItem / AttributeBucket 结构。
nextCursorstringnullable
下一页的不透明游标;最后一页为 null。
sourceGapsstring[]
请求了但无覆盖的市场(buff163 单市场切片下为空)。
BuffHistoryResponse仅 buff163 的饰品属性价格历史。
bucketSchemaVersioninteger
分桶结构的 schema 版本。
marketstring
恒为 buff163。
currencystring
恒为 USD。
granularitystring
点间隔,例如 10m。
每个饰品一条;分桶沿用 AttributeHistoryBucket / AttributeHistoryPoint 结构。
sourceGapsstring[]
请求了但无覆盖的市场。
MinPricesResponse所请求饰品在各市场的最低在售价。snake_case。
每件被请求的饰品一条。
ItemMinPrices某饰品在各市场的最低价。
canonical_item_idstring
规范饰品 id。
market_hash_namestring
Market hash name。
各市场最低在售价。
MarketMinPrice单个市场的最低在售价。价格为美分。
market_namestring
市场 id。
offersinteger
该饰品在该市场上被跟踪的挂单总数(报价规模,而不是价格等于或高于 price 的挂单数)。
priceinteger
最低在售价,单位美分。
updated_atstring (date-time)
SkinPricer 最近一次从该市场抓取该报价的时间(与价格类接口上的 fetchedAt 为同一值)。
is_stalebooleannullable
已超出新鲜度阈值,但仍在回退时效内。
ingested_atstring (date-time)nullable
SkinPricer 摄取的时间。
ingest_latency_msintegernullable
抓取到摄取的延迟,毫秒。
ItemSearchResponse分页的目录搜索结果,附每件饰品的价格。
每件饰品一个跨市场快照(与价格快照接口结构相同)。
paginationPaginationMeta
分页元数据。
PaginationMeta分页封装。
perPageinteger
每页饰品数。
currentPageinteger
当前页(从 1 开始)。
frominteger
本页第一件饰品的序号。
tointeger
本页最后一件饰品的序号。
totalinteger
所有页合计的饰品总数。
lastPageinteger
最后一页的页码。
prevPageintegernullable
上一页;在第一页时为 null。
nextPageintegernullable
下一页;在最后一页时为 null。
LiquidityResponse饰品的流动性与预计售出时间。时间单位为小时,价格为美分。
canonicalItemIdstring
规范饰品 id。
marketHashNamestring
Market hash name。
liquidityBadgestring
EXTREMELY_LIQUID | VERY_LIQUID | LIQUID | ILLIQUID | VERY_ILLIQUID | EXTREMELY_ILLIQUID;没有可支撑的估算时为 INSUFFICIENT_DATA(此时售出时间字段为 null)。INSUFFICIENT_DATA 并不表示零交易。较早缓存的响应可能仍带有旧值 UNTRADED。
confidencestring
HIGH | MEDIUM | LOW | CRITICAL。
coveragestring
full | partial | none 市场覆盖度。
medianTimeToSellHoursnumbernullable
在最佳市场上的售出时间中位数。
p90TimeToSellHoursnumbernullable
在最佳市场上的售出时间 p90。
bestMarketToListstringnullable
预计售出时间最短的市场。
salesPerDaynumbernullable
最佳市场上的每日成交量(滚动 24 小时)。
activeListingsintegernullable
最佳市场上的有效挂单数。
referenceAskUsdCentsintegernullable
估算所假设的在售价。
marketWideSalesPerDaynumbernullable
各已覆盖市场的每日成交量合计。
marketWideListingsintegernullable
各已覆盖市场的有效挂单合计。
marketsWithSalesinteger
成交速度为正的已覆盖市场数。
marketsWithDepthinteger
有正供给的已覆盖市场数。
marketWideMedianTimeToSellHoursnumbernullable
消化整个跨市场供给所需的时间(饱和度指数)。
marketWideP90TimeToSellHoursnumbernullable
饱和度指数的 p90。
按市场的拆分。
notesstring[]
数据质量标志,例如 sales_data_stale:marketcsgo。
calculatedAtstring (date-time)
计算时间。
LiquidityMarketMetric单个市场的流动性指标。
marketstring
市场 id。
salesPerDaynumbernullable
每日成交量(滚动 24 小时)。
activeListingsintegernullable
价格等于或高于最优在售价的有效挂单数。
bestAskUsdCentsintegernullable
当前最优在售价,单位美分。
medianTimeToSellHoursnumbernullable
售出时间中位数。
p90TimeToSellHoursnumbernullable
售出时间 p90。
salesDataAgeMinutesnumbernullable
所用成交快照的时效(分钟)。
listingsDataAgeMinutesnumbernullable
所用挂单簿快照的时效(分钟)。
MarketAnalyticsResponse饰品按市场的当前与窗口期分析。snake_case。
canonical_item_idstring
规范饰品 id。
market_hash_namestring
Market hash name。
window_hoursinteger
分析窗口(小时)。
每个市场一行。
calculated_atstring (date-time)
分析的计算时间。
MarketAnalyticsPoint单个市场的当前报价与窗口期统计。所有价格字段(包括当前值与窗口值)都是整数美分;*_count / *_quantity 统计是普通计数。
marketstring
市场 id。
current_askintegernullable
当前最优在售价,单位美分。
current_bidintegernullable
当前最优求购价,单位美分。
spread_bpsintegernullable
当前价差,以基点计。
ask_is_stalebooleannullable
当前在售价已过期。
bid_is_stalebooleannullable
当前求购价已过期。
current_listing_countintegernullable
当前在售挂单数。
current_buy_order_countintegernullable
当前求购单数。
current_bid_quantityintegernullable
当前求购数量合计。
sell_avg_pricenumbernullable
窗口期内的在售均价,单位美分(可能带小数美分)。
sell_min_priceintegernullable
窗口期内的最低在售价,单位美分。
sell_max_priceintegernullable
窗口期内的最高在售价,单位美分(已做离群值截断)。
sell_avg_listing_countnumbernullable
窗口期内的平均在售挂单数(是计数,不是价格)。
buy_avg_pricenumbernullable
窗口期内的求购均价,单位美分(可能带小数美分)。
buy_max_priceintegernullable
窗口期内的最高求购价,单位美分。
buy_avg_order_countnumbernullable
窗口期内的平均求购单数(是计数,不是价格)。
buy_avg_total_quantitynumbernullable
窗口期内的平均求购数量合计(是计数,不是价格)。
MaxOrdersResponse所请求饰品在各市场的最高求购单。snake_case。
每件被请求的饰品一条。
ItemMaxOrders某饰品在各市场的最高求购单。
canonical_item_idstring
规范饰品 id。
market_hash_namestring
Market hash name。
各市场最高求购单。
MarketMaxOrder单个市场的最高求购单。价格为美分。
market_namestring
市场 id。
offersinteger
该饰品在该市场上被跟踪的求购单总数(报价规模,而不是该价位上的订单数)。
priceinteger
最高求购价,单位美分。
updated_atstring (date-time)
SkinPricer 最近一次从该市场抓取该报价的时间(与价格类接口上的 fetchedAt 为同一值)。
is_staleboolean
已超出新鲜度阈值,但仍在回退时效内。
total_quantityintegernullable
近似的求购数量合计。
ingested_atstring (date-time)nullable
SkinPricer 摄取的时间。
ingest_latency_msintegernullable
抓取到摄取的延迟,毫秒。
AllItemsItem完整目录数组中的一件饰品。响应是由它组成的裸数组(无封装)。
idstring
规范饰品 id。
namestring
Market hash name。
latestPricesAllItemsPrice[]
各市场最新价格。
priceAggregatesAllItemsAggregatenullable
跨市场聚合值,或 null。
AllItemsPrice某市场上该饰品的最新价格。
marketstring
市场 id。
effectiveUsdCentsinteger
最新价格,单位美分。
fetchedAtstring (date-time)
SkinPricer 最近一次从该市场抓取该价格的时间。
originalCurrencystring
统一换算前的来源币种。
AllItemsAggregate该饰品的跨市场价格聚合值。
minPriceintegernullable
全市场最低价。
maxPriceintegernullable
全市场最高价。
avgPricenumbernullable
价格均值。
medianPriceintegernullable
价格中位数。
stdDevnumbernullable
价格标准差。
updatedAtstring (date-time)
聚合值的计算时间。
LatestPricesResponse某款游戏中所有具备可用报价的饰品,打包为一份快照。
generatedAtstring (date-time)
快照构建开始的时间。快照中的每条报价都在此时间或之后读取。同时以 Last-Modified 返回。
gamestring
cs2 或 rust,与请求一致。
currencystring
恒为 USD:所有价格字段的币种。
至少有一条可用报价的全部目录饰品,按 canonicalItemId 排序。
itemCountinteger
items 中的条目数。
LatestPriceItem单件饰品的最新价格:数值与单件价格接口的默认全市场视图一致。
namestring
Market hash name。
canonicalItemIdstring
规范饰品 id,与其他接口返回的 id 相同。
bestAskQuotenullable
全市场最低在售价。没有任何市场有在售价时为 null。
bestBidQuotenullable
可现金变现市场中的最高求购价。没有时为 null;这种情况很常见(不少饰品没有可现金变现的求购价),请务必做 null 检查。
每个市场一条在售价。
每个有求购单的市场一条求购价;可能为空。
LatestPriceAsk单个市场的在售价。价格为美分。
marketstring
市场 id。
priceinteger
在售价,单位美分。
fetchedAtstring (date-time)
SkinPricer 最近一次从该市场抓取该报价的时间。
isStaleboolean
构建快照时报价已超过 30 分钟则为 true。
quoteSizeinteger
最优在售价上的挂单数。
originalPriceCentsinteger
未经调整的来源价格,以来源币种的最小单位计(例如人民币的分、美元的美分)。仅与 originalCurrency 一同出现;否则省略,绝不为 null。
originalCurrencystring
来源价格的 ISO 币种,例如 CNY 或 USD。仅与 originalPriceCents 一同出现;否则省略,绝不为 null。
sourceUpdatedAtstring (date-time)
市场自身生成该价格的时间。市场未提供时间时省略。来源类型与时效仅在单品定价接口中提供。
LatestPriceBid单个市场的最高求购单。价格为美分。在来源提供时,求购价同样可以携带 originalPriceCents / originalCurrency。
marketstring
市场 id。
priceinteger
求购价,单位美分。
fetchedAtstring (date-time)
SkinPricer 最近一次从该市场抓取该报价的时间。
isStaleboolean
构建快照时报价已超过 30 分钟则为 true。
quoteSizeinteger
最优求购价上报告的数量。
originalPriceCentsinteger
未经调整的来源价格,以来源币种的最小单位计(例如人民币的分、美元的美分)。仅与 originalCurrency 一同出现;否则省略,绝不为 null。
originalCurrencystring
来源价格的 ISO 币种,例如 CNY 或 USD。仅与 originalPriceCents 一同出现;否则省略,绝不为 null。
totalQuantityinteger
该市场公开的各价位上报告的求购数量合计。
totalOrdersCountintegernullable
经核实的订单数,仅在来源提供时返回(目前为悠悠有品 Youpin);否则省略。
orderBookCompletebooleannullable
来源的挂单簿被提前截断时为 false,此时数量为下限值。仅在来源提供时返回。
LiquiditySummary饰品的精简流动性徽章视图。
marketHashNamestring
Market hash name。
liquidityBadgestring
EXTREMELY_LIQUID | VERY_LIQUID | LIQUID | ILLIQUID | VERY_ILLIQUID | EXTREMELY_ILLIQUID;没有可支撑的估算时为 INSUFFICIENT_DATA(此时售出时间字段为 null)。INSUFFICIENT_DATA 并不表示零交易。较早缓存的响应可能仍带有旧值 UNTRADED。
liquiditystring
小写标签;INSUFFICIENT_DATA(以及旧值 UNTRADED)映射为 unknown。
estimatedSaleTimestring
便于阅读的售出时间,例如 2 - 6 hours。
confidencestring
HIGH | MEDIUM | LOW | CRITICAL。
scoreintegernullable
0 到 100(越高卖得越快);无成交时为 null。
bestMarketToListstringnullable
预计售出时间最短的市场。
calculatedAtstring (date-time)
计算时间。
LiquidityBatchResponse一次调用评估多件饰品的流动性。
每件已收录饰品一条完整的流动性结果。
notFoundstring[]
请求中未收录的名称。
requestedinteger
请求的饰品数。
calculatedAtstring (date-time)
本批次的计算时间。
LiquidityBulkResponse全目录流动性映射。Enterprise。
versionstring
不透明的快照版本,形如 <ms>-<pid>(生成时的毫秒时间 + worker pid)。只用于判断是否相等。它同时也是 ETag;不要解析它。
calculatedAtstring (date-time)
快照生成时间。
cadencestring
重算周期(ISO-8601 时长),例如 PT10M。
marketsstring[]
覆盖的市场。
itemCountinteger
快照中的饰品数。
itemsobject
market_hash_name 到 LiquidityBulkItem 的映射。
LiquidityBulkItem批量映射中单件饰品的流动性(snake_case 与 camelCase 键混用)。
market_hash_namestring
Market hash name。
liquiditystring
小写的流动性标签。
estimated_sale_timestring
便于阅读的售出时间。
liquidityBadgestring
7 个取值的徽章枚举。
confidencestring
HIGH | MEDIUM | LOW | CRITICAL。
scoreintegernullable
0 到 100;无成交时为 null。
bestMarketToListstringnullable
最适合上架的市场。
variantsobject
按变体的流动性(预留字段;目前为 {})。
LiquidityBulkManifest批量流动性映射的变更探测。Enterprise。
versionstring
不透明的快照版本,形如 <ms>-<pid>(同时也是 ETag)。只用于判断是否相等。
calculatedAtstring (date-time)
快照生成时间。
cadencestring
重算周期,例如 PT10M。
marketsstring[]
覆盖的市场。
itemCountinteger
快照中的饰品数。
MarketLatencyResponse各市场的摄取延迟与可靠性。snake_case。
每个市场一行。
window_hoursinteger
统计所覆盖的滚动窗口。
measured_atstring (date-time)
统计的测量时间。
MarketLatency单个市场的延迟与可靠性。
marketstring
市场 id。
avg_latency_msinteger
平均抓取延迟,毫秒。
p95_latency_msinteger
p95 抓取延迟,毫秒。
p99_latency_msinteger
p99 抓取延迟,毫秒。
fetch_countinteger
窗口内的抓取次数。
error_ratenumber
出错抓取的比例(0 到 1)。
slo_breach_ratenumber
超出延迟 SLO 的比例(0 到 1)。
FreshnessResponse各市场摄取新鲜度 + 整体汇总。snake_case。
每个已摄取市场一行。
overall_statusstring
汇总:healthy | degraded | stale。
checked_atstring (date-time)
新鲜度采样时间。
MarketFreshness单个市场的新鲜度。
marketstring
市场 id。
delay_secondsinteger
距最后一次摄取事件的秒数。
last_updatestring (date-time)
最后摄取事件时间。
statusstring
healthy | degraded | stale。
MarketHealth[]数组,每个已接入市场一条。无需密钥。
idstring
市场 id。其他接口的关联键。
statusstring
live | warn | stale。
lastEventAtstring (date-time)nullable
最后摄取事件;尚无事件时为 null。
listingsCountinteger
在该市场最长时效内(1 小时;steamcommunity 为 6 小时)抓取的挂单数。没有这么新的挂单时为 0,例如该市场抓取暂停期间。
freshnessCoveragePctintegernullable
该市场所返回挂单行中,在其预期刷新窗口内完成刷新的比例(0 到 100)。没有返回任何行时为 null。与只跟踪摄取心跳的 status 互为补充。
healthBarsinteger[]
48 个 30 分钟分桶(约 24 小时),最新在末尾。图例:2 = 正常、1 = 降级、0 = 宕机。

使用与许可

API 及其数据的使用受我们的服务条款(英文)约束:不得转售或再分发数据,不得用于构建竞争性服务, 不得超出套餐的速率限制;在条款允许展示数据的场景下须注明数据来源为 SkinPricer。滥用行为可能被限流或封禁。