GET/v1/aggregations/max-ordersDEVELOPER+

Aggregated Max Orders

Batch lookup of the highest buy order per market for up to 100 items at once: the bid-side mirror of min-prices. Pass market hash names (or canonical item ids); each item comes back with its top buy order on every requested market. Response is snake_case. Prices are integer USD cents.

The bid-side mirror of min-prices: hand it up to 100 market hash names (or canonical item ids) and get each item's highest buy order on every requested market. total_quantity approximates the depth behind that order. Response is snake_case.

Parameters

marketHashNamesstringoptional

Query. CSV of market hash names, max 100. Provide this OR ids.

idsstringoptional

Query. CSV of canonical item ids, max 100. Provide this OR marketHashNames.

marketsstringoptional

Query. CSV of market ids to restrict the response.

Response fields

MaxOrdersResponseHighest buy order per market for the requested items. snake_case.

itemsItemMaxOrders[]

One entry per requested item.

Nested and shared shapes link to the API Objects reference.

Response 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
        }
      ]
    }
  ]
}

Errors

400Neither marketHashNames nor ids supplied, or more than 100 items.

401 / 403Missing, invalid, or insufficient-plan API key.

429Rate limit exceeded; see Retry-After + X-RateLimit-* headers.

5xxUpstream snapshot unavailable or a server-side issue. Retry with backoff.

curl "https://pricing.skinpricer.com/v1/aggregations/max-orders" \
  -H "Authorization: ApiKey sk_live_•••••••••••"

Authenticated endpoint — call it with your API key from your own client (see the code sample).

Response headers

X-RateLimit-Limit: <per-minute, set by your plan>

X-RateLimit-Remaining: <remaining this minute>

X-RateLimit-Reset: <seconds to reset>

X-Request-ID: req_xxxxxxxxxxxxxxxx