GET/v1/nbbo/depthDEVELOPER+

挂单深度

NBBO 附近的聚合挂单深度：排序后的在售与求购档位，含累计数量及各市场的贡献报价。用 depth 设置档位数（1 到 50，默认 10）。价格为整数美分。

把 NBBO 附近的挂单簿聚合为排序档位（asks 从低到高、bids 从高到低），每档携带 cumulativeQuantity，可直接读出距盘口 X 美分内有多少量。

每档列出构成它的各市场 quotes，因此你能看到每个价位的流动性来自哪些平台。用 depth（1 到 50，默认 10）设置每边的档位数。

Parameters

market_hash_namestringoptional

查询参数。精确的 market hash name。此参数与 id 二选一（都缺失返回 400）。

idstringoptional

查询参数。规范饰品 id。此参数与 market_hash_name 二选一（都缺失返回 400）。

marketsstringoptional

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

depthintegeroptional

查询参数。每边档位数，1 到 50。默认：10。

Response fields

DepthResponseNBBO 附近的聚合挂单深度。

marketHashNamestring

Market hash name。

canonicalItemIdstring

规范饰品 id。

depthinteger

每边请求的档位数（1 到 50）。

marketCountinteger

参与的市场数。

asksDepthLevel[]

排序后的在售档位，最优在前。

bidsDepthLevel[]

排序后的求购档位，最优在前。

spreadBpsintegernullable

盘口价差（基点）。与 /v1/nbbo 和 /v1/pricing 不同，不做裁剪：盘口交叉时可能很大或为负。

lockedboolean

盘口求购价 == 盘口在售价。

crossedboolean

盘口求购价 > 盘口在售价。

calculatedAtstring (date-time)

计算时间。

嵌套与共享结构链接到 API Objects 参考页（英文）。

Response 200

{
  "marketHashName": "Glock-18 | Water Elemental (Factory New)",
  "canonicalItemId": "cmlofca920lka01yozajhixt3",
  "depth": 4,
  "marketCount": 14,
  "asks": [
    {
      "rank": 1,
      "price": 6240,
      "quantity": 23,
      "ordersCount": 23,
      "marketCount": 1,
      "cumulativeQuantity": 23,
      "updatedAt": "2026-06-23T17:53:23.000Z",
      "isStale": true,
      "quotes": [
        {
          "market": "dmarket",
          "level": 1,
          "price": 6240,
          "quantity": 23,
          "ordersCount": 23,
          "updatedAt": "2026-06-23T17:53:23.000Z",
          "isStale": true
        }
      ]
    }
  ],
  "bids": [
    {
      "rank": 1,
      "price": 9145,
      "quantity": 1,
      "ordersCount": 1,
      "marketCount": 1,
      "cumulativeQuantity": 1,
      "updatedAt": "2026-06-23T20:23:03.000Z",
      "isStale": true,
      "quotes": [
        {
          "market": "steamcommunity",
          "level": 1,
          "price": 9145,
          "quantity": 1,
          "ordersCount": 1,
          "updatedAt": "2026-06-23T20:23:03.000Z",
          "isStale": true
        }
      ]
    }
  ],
  "spreadBps": -3177,
  "locked": false,
  "crossed": true,
  "calculatedAt": "2026-06-23T22:07:15.107Z"
}

Errors

400market_hash_name 与 id 均未提供，或 depth 不在 1 到 50 范围内。

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

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

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