GET/v1/aggregations/min-pricesDEVELOPER+

聚合最低在售价

批量查询：一次最多 100 件饰品，返回每个市场的最低在售价。传入 market hash name（或规范饰品 ids），每件饰品都会带回它在每个被请求市场上的最低价。响应为 snake_case。价格为整数美分。

一个批量辅助接口：传入最多 100 个 market hash name（或规范饰品 ids），一次往返即可拿到每件饰品在每个被请求市场上的最低在售价，而不必逐件调用 /v1/nbbo。响应为 snake_case。没有数据的饰品（或未收录的名称）会被静默丢弃。响应里没有 notFound[]，请把返回的饰品与你请求的列表做比对。只有当请求的饰品一件都无法解析时才会返回 400。

offers 是该饰品在该市场上被跟踪的挂单总数（即报价规模），而不是以 price 为条件的计数；is_stale 标记已超出新鲜度窗口的报价（仍会作为回退值返回）。求购侧的镜像接口 max-orders 结构相同，只是用 orders[] 代替 prices[]。

参数

marketHashNamesstring可选

查询参数。market hash name 的 CSV，最多 100 个。此参数与 ids 二选一。

idsstring可选

查询参数。规范饰品 id 的 CSV，最多 100 个。此参数与 marketHashNames 二选一。

marketsstring可选

查询参数。用于限定响应的市场 id CSV，例如 skinport,csfloat,buff163。

响应字段

MinPricesResponse所请求饰品在各市场的最低在售价。snake_case。

itemsItemMinPrices[]

每件被请求的饰品一条。

嵌套与共享结构链接到 API 对象参考页。

错误

400marketHashNames 与 ids 均未提供、超过 100 件，或请求的饰品没有一件能解析为已收录饰品。

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

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

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

5xx上游快照不可用或服务端问题。请退避后重试。

另见单件 NBBO 完整快照

配套接口

GET/v1/aggregations/max-orders

求购侧的镜像接口：对同样的 ids 返回每个市场的最高求购单。封装相同，但每件饰品携带的是 orders[]（其中 price 为最高求购价，另有 total_quantity），而不是 prices[]。

完整参考 →

使用此端点的指南（英文）

export SKINPRICER_API_KEY="sp_live_•••"

curl -G "https://pricing.skinpricer.com/v1/aggregations/min-prices" \
  --data-urlencode "marketHashNames=AK-47 | Redline (Field-Tested),AWP | Asiimov (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 { items } = await client.aggregations.minPrices({
  marketHashNames: ["AK-47 | Redline (Field-Tested)", "AWP | Asiimov (Field-Tested)"],
});
for (const it of items) console.log(it.market_hash_name, it.prices.length, "markets");

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/aggregations/min-prices",
    params={"marketHashNames": "AK-47 | Redline (Field-Tested),AWP | Asiimov (Field-Tested)"},
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

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

响应 200

{
  "items": [
    {
      "canonical_item_id": "cmlofca920lka01yozajhixt3",
      "market_hash_name": "Glock-18 | Water Elemental (Factory New)",
      "prices": [
        {
          "market_name": "csfloat",
          "offers": 132,
          "price": 6500,
          "updated_at": "2026-06-23T21:52:27.427Z",
          "is_stale": false,
          "ingested_at": "2026-06-23T21:55:56.923Z",
          "ingest_latency_ms": 209496
        },
        {
          "market_name": "skinport",
          "offers": 40,
          "price": 6516,
          "updated_at": "2026-06-23T21:51:53.531Z",
          "is_stale": false,
          "ingested_at": "2026-06-23T21:54:30.775Z",
          "ingest_latency_ms": 157244
        }
      ]
    }
  ]
}

响应头

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

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

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

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

X-Request-ID: req_xxxxxxxxxxxxxxxx