24h成交量—未平仓—24h爆仓$1.36B24h多空比—BTC市占—ETH市占—

App

语言 ▾

¥ CNY ▾

/api/sd/liquidity/rank

GET部分可用PARTIAL

按订单簿深度排名的币种

按单一价格带内的聚合订单簿深度（买盘 + 卖盘）对币种排名，并给出所含合约数量和最小买卖价差。

GET/api/sd/liquidity/rank

请求

查询参数

名称	类型	必填	默认值	可选值	说明
market	string	可选	perp	perp, spot	市场类型。永续合约订单簿与现货订单簿绝不相加。
band	string	可选	1	0.5, 1, 2	距中间价的百分比距离。
limit	integer	可选	50	≥ 1 · ≤ 200	行数。

请求示例

curl -s "https://www.coinboss.com/api/sd/liquidity/rank"

响应字段

字段表根据真实响应生成，因此所列内容与端点实际返回的完全一致。路径中 a[] 表示数组元素，{*} 表示以动态名称（如币种或交易所）为键的对象。

字段	类型	单位	说明
success	boolean	—	请求成功时为 true。失败时响应体为 `{ success: false, code, error, request_id }`。
schema	string	—	本响应的结构 ID。仅当已有字段的含义或类型发生变化时才会改变。
now	number	ms	响应生成时的服务器时间。
market	string	—	`perp` 或 `spot`。
band_pct	number	%	所选价格带：距中间价的距离。
limit	number	—	实际应用的行数上限。
total_coins	number	—	至少有一行订单簿数据的币种。
rows	array	—	每个币种一行。
rows[]	object	—	每个币种一行。
rows[].coin	string	—	币种代码（大写）。
rows[].bid_depth_usd	number	USD	中间价与价格带下沿之间的买盘挂单名义价值。`complete` 为 false 时为下限值。
rows[].ask_depth_usd	number	USD	中间价与价格带上沿之间的卖盘挂单名义价值。`complete` 为 false 时为下限值。
rows[].total_depth_usd	number	USD	该价格带的买盘深度 + 卖盘深度，仅用作排名键。
rows[].n_included	number	—	计入深度合计的行数：新鲜且在该价格带内完整。请与深度值一并读取。
rows[].n_fresh	number	—	新鲜的行数。
rows[].n_rows	number	—	找到的行数，包括过期的行。
rows[].mid_median	number	USD	新鲜行的中间价中位数。
rows[].spread_bps_min	number	bp	新鲜行中最小的买卖价差。
rows[].included_exchanges	array	—	新鲜数据已计入的数据源。
rows[].included_exchanges[]	string	—	新鲜数据已计入的数据源。
rows[].uses_aggregated_buckets	boolean	—	有已计入的行使用了按价格聚合的桶时为 true，此时合计为下限值。
rows[].rank	number	—	排名位置；该行没有可供排名的数值时为 `null`。
coverage	object	—	这些数值包含什么、不包含什么。在与其他数据源比较合计之前，请先比对这一点。
coverage.included_exchanges	array	—	新鲜数据已计入的数据源。
coverage.included_exchanges[]	string	—	新鲜数据已计入的数据源。
coverage.unavailable	array	—	无法计入的数据源，每项均附原因。它们绝不会按 0 计。在生成此表所用的样本中为空
coverage.stale_excluded	array	—	因最近一次更新超出新鲜窗口而被排除的行。
coverage.stale_excluded[]	object	—	因最近一次更新超出新鲜窗口而被排除的行。
coverage.stale_excluded[].exchange	string	—	交易所 ID（小写）。
coverage.stale_excluded[].age_s	number	s	距收到该行的秒数。
coverage.n_fresh_rows	number	—	全部币种的新鲜行数。
coverage.n_stale_rows	number	—	全部币种的过期行数。
coverage.n_incomplete_rows	number	—	快照未覆盖到价格带边沿的新鲜行。
method	object	—	以纯文本说明本响应所用的公式，每个字段一条。
method.bid_depth_usd	string	—	`bid_depth_usd` 的公式说明，纯文本。
method.ask_depth_usd	string	—	`ask_depth_usd` 的公式说明，纯文本。
method.complete	string	—	`complete` 的公式说明，纯文本。
method.aggregate	string	—	`aggregate` 的公式说明，纯文本。
method.fresh	string	—	`fresh` 的公式说明，纯文本。
method.rank	string	—	`rank` 的公式说明，纯文本。
meta	object	—	本响应的数据来源与新鲜度。
meta.schema	string	—	本响应的结构 ID。仅当已有字段的含义或类型发生变化时才会改变。
meta.source	array	—	采集数据所用的上游公开端点。
meta.source[]	object	—	采集数据所用的上游公开端点。
meta.source[].exchange	string	—	交易所 ID（小写）。
meta.source[].market	string	—	`perp` 或 `spot`。
meta.source[].endpoint	string	—	采集器读取的数据源公开端点（仅用于说明数据来源；客户端不会调用它）。
meta.observed_at	number	ms	数据源为该数据给出的时间戳。
meta.received_at	number	ms	CoinBoss 采集器收到该数据的时间。
meta.fetched_at	number	ms	本响应的组装时间。
meta.window	string	—	这些数值覆盖的时间窗口。
meta.quality	string	—	FRESH、PARTIAL、STALE、BROKEN 或 UNAVAILABLE，根据数据时间戳和覆盖范围判定。
meta.is_stale	boolean	—	数据早于其新鲜窗口时为 true。
meta.cache_ttl_s	number	s	本响应的缓存有效期。
meta.fallback	string	—	采集器或数据源出现故障时端点返回的内容。
meta.collector_heartbeat_age_s	number	s	距采集器最近一次上报自身在运行的秒数。

生成于 2026-11-11 23:00 UTC，基于 3 个真实响应。

响应示例

/api/sd/liquidity/rank · 真实响应，采集于 2026-11-13 04:02:46 UTC。为便于展示，较长的数组和映射已被截短：rows 原有 50 项; meta.source 原有 23 项; coverage.stale_excluded 原有 23 项; rows[].included_exchanges 原有 19 项; coverage.included_exchanges 原有 23 项。

{
- "success": true,
- "schema": "coinboss.sd.liquidity/1",
- "now": 1794542566023,
- "market": "perp",
- "band_pct": 1,
- "limit": 50,
- "total_coins": 89,
- "rows": [
  - { … 12 },
  - { … 12 }
  ],
- "coverage": {
  - "included_exchanges": [ … 8 ],
  - "unavailable": [],
  - "stale_excluded": [ … 2 ],
  - "n_fresh_rows": 1481,
  - "n_stale_rows": 82,
  - "n_incomplete_rows": 8
  },
- "method": {
  - "bid_depth_usd": "sum of resting bid notional with price >= mid * (1 - band%), in USD; notional = price * size * contract_value (inverse contracts: size * contract_value); USDT /…",
  - "ask_depth_usd": "sum of resting ask notional with price <= mid * (1 + band%), in USD; same notional rule as bid_depth_usd",
  - "complete": "true when BOTH sides of the snapshot reach the band edge (reach_pct >= band) or the whole side of the book was returned; when false the depth values are lower b…",
  - "aggregate": "per market and band: sum over rows that are fresh AND complete for that band; n_included / n_fresh is the denominator; lower_bound_* additionally adds the incom…",
  - "fresh": "a row is fresh when now - received_at <= max(3 * period_s, 300s); stale rows are listed in coverage.stale_excluded; rows older than 24h are dropped",
  - "rank": "coins ordered by bid_depth_usd + ask_depth_usd of the chosen market and band, aggregated as in aggregate; coins with no fresh complete row carry nulls and sort …"
  },
- "meta": {
  - "schema": "coinboss.sd.liquidity/1",
  - "source": [ … 2 ],
  - "observed_at": 1794542565862,
  - "received_at": 1794542565977,
  - "fetched_at": 1794542566023,
  - "window": "latest",
  - "quality": "PARTIAL",
  - "is_stale": false,
  - "cache_ttl_s": 30,
  - "fallback": "stale rows (older than max(3 * period_s, 300s)) are left out; coins whose rows are all stale or incomplete keep their place in the list with null depth",
  - "collector_heartbeat_age_s": 4
  }
}

已验证的样本

除上面的示例外，探针还会使用以下参数调用该端点，并在每次调用时校验结构。

参数	HTTP	延迟	结果
market=spot	200	5 ms	通过 PARTIAL
band=0.5&limit=10	200	7 ms	通过 PARTIAL
limit=0	400	2 ms	通过返回预期的错误

检查于 2026-11-13 03:58:06 UTC

详细信息

身份验证: 无。公开端点。
速率限制: 每个 IP 每分钟 1200 次请求
服务端缓存: 30s
边缘微缓存: 10s
更新频率: 与 `/api/sd/liquidity` 同一采集周期。
时间窗口: 每个合约的最新快照。
数据来源: 24 家交易所（永续合约与现货市场）的公开 REST 订单簿快照，由 CoinBoss 采集并存储（sd_book_latest、sd_book_hist）。深度和滑点由 CoinBoss 根据原始价格档位计算。
交易所覆盖范围: 24 家交易所，38 条交易所 × 市场通道。如果公开快照无法覆盖中间价 ±0.5 / 1 / 2 %（受交易所档位数量上限所限），该价格带会被标记为 `complete: false`，其数值为下限值，且不计入聚合值；`n_included` / `n_fresh` 给出分母，`excluded_incomplete` 列出被排除的项。
分页: 不分页；`limit` 限制行数上限（最大 200）。
排序: 按 `total_depth_usd` 降序；没有任何完整且新鲜数据行的币种排在最后，其 `rank: null`。
单位: Depth in USD notional, bid and ask side reported separately and never added. Spread and slippage in basis points (1 bp = 0.01 %). USDT / USDC / USD quotes are counted 1:1 as USD.
时间戳: 除非字段说明另有注明，均为 Unix 纪元毫秒（UTC）
响应格式: json
稳定性: 稳定
上线时间: 2026-11-11

实时状态

部分可用检查于 2026-11-13 04:02:46 UTCHTTP 2009 ms结构一致最新数据点距今 0s

该端点上报的数据质量为 PARTIAL

近 30 天可用性

408 次检查中 100% 通过

错误

所有端点的失败响应格式一致。完整列表见错误页面。错误与速率限制 →

错误码	HTTP	含义	处理方式
INVALID_PARAM	400	缺少必填参数，或某个取值不被接受。已知是哪个参数时，`param` 会给出其名称。	请勿原样重试；请修正请求。
UNAUTHORIZED	401	已发送 `CB-API-KEY` 请求头，但该密钥未知或已被吊销。公开数据无需密钥，请去掉该请求头或使用有效密钥。	请勿原样重试。
FORBIDDEN	403	该路由不属于公开 API（内部或仅限账户使用）。	请勿重试。
NOT_FOUND	404	未知路由，或所请求的币种 / 交易所 / 基金不存在。	请勿重试；请对照目录检查路径和标识符。
RATE_LIMITED	429	请求数超过每分钟限额。`Retry-After` 给出需要等待的秒数。	等待 `Retry-After` 指定的时间后，再以退避方式重试。
INTERNAL	500	意外的服务器错误。错误信息有意保持通用；报告问题时请附上 `request_id`。	几秒后重试一次；若问题持续，请附上请求 ID 报告。
UPSTREAM_FAILED	503	该端点背后的数据源未及时响应。不会返回过期数据或替代数值来顶替。	以退避方式重试；并查看状态页。
UNAVAILABLE	501 / 503	数据集暂时未就绪（缓存预热中），或该端点尚无合法的公开数据源。	请稍后重试；目录会标出因设计原因而不可用的端点。
REQUEST_FAILED	200	部分较旧的端点会以 HTTP 200 返回 `success: false`。请务必检查 `success`，而不只是 HTTP 状态码。	取决于具体信息；按请求失败处理。

试一试

GET/api/sd/liquidity/rank部分可用

参数

market

string · 默认 perp — Market type. Perpetual and spot books are never added together.

band

string · 默认 1 — Distance from mid price in percent.

limit

integer · 默认 50 · 最小 1 · 最大 200 — Number of rows.

请求 URLhttps://www.coinboss.com/api/sd/liquidity/rank

选择一个端点，然后点击“发送请求”。响应、响应头和耗时将显示在这里。

订单簿深度与滑点 /api/sd/liquidity
订单簿深度历史 /api/sd/liquidity/history
按订单簿深度排名的币种 /api/sd/liquidity/rank
大额挂单监控 /api/indicators/large-orderbook