GET/v1/aggregations/max-ordersDEVELOPER+

聚合最高求购价

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

min-prices 的求购侧镜像：传入最多 100 个 market hash name（或规范饰品 ids），拿到每件饰品在每个被请求市场上的最高求购单。total_quantity 近似表示该求购单背后的深度。响应为 snake_case。

参数

marketHashNamesstring可选

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

idsstring可选

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

marketsstring可选

查询参数。用于限定响应的市场 id CSV。

响应字段

MaxOrdersResponse所请求饰品在各市场的最高求购单。snake_case。

itemsItemMaxOrders[]

每件被请求的饰品一条。

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

错误

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

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

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

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

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

另见最低在售价（在售侧）单件 NBBO

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

How to value a CS2 inventory at live market prices

export SKINPRICER_API_KEY="sp_live_•••"

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

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/aggregations/max-orders",
    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)",
      "orders": [
        {
          "market_name": "buff163",
          "offers": 47,
          "price": 6440,
          "updated_at": "2026-06-23T21:59:48.717Z",
          "is_stale": false,
          "total_quantity": 47,
          "ingested_at": "2026-06-23T21:59:48.000Z",
          "ingest_latency_ms": 0
        }
      ]
    }
  ]
}

响应头

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

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

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

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

X-Request-ID: req_xxxxxxxxxxxxxxxx