24h成交量—未平仓—24h爆仓$1.36B24h多空比—BTC市占—ETH市占—
App
语言 ▾
¥ CNY ▾
/api/liq-map
GET可用

清算地图

清算地图（各价位、各杠杆倍数下的估算清算规模）

GET/api/liq-map

请求

查询参数

名称类型必填默认值可选值说明
symbolstring可选BTC—币种代码；没有数据时返回 404。 示例: BTC
rangestring可选1d1d, 7d时间窗口。 示例: 1d

请求示例

curl -s "https://www.coinboss.com/api/liq-map?symbol=BTC&range=1d"

响应字段

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

字段类型单位说明
symbolstring—经 CoinBoss 归一化的合约代码（例如 BTCUSDT）。
rangestring—请求的时间窗口。
updatedAtnumberms数据最近一次更新的时间。
currentPricenumber—当前价格。
binWidthnumberUSD单个价格分档的宽度：价格轴以 `currentPrice` 为中心覆盖 ±10 %（`1d`）或 ±18 %（`7d`），并划分为 200 个分档。
leveragesarray—模型分配仓位所用的杠杆档位，按升序排列（10、25、50、100）。
leverages[]numberx单个档位的杠杆倍数；在 `bins[].tiers` 中用作键。
binsarray—清算地图的 200 个价格分档，按价格升序排列；属于模型估算，并非交易所数据。
bins[]object—一个价格分档：中间 `price`、`side`（低于当前价格为 `long`，等于或高于当前价格为 `short`）、各杠杆档位的 `tiers` 及其 `total`。
bins[].pricenumber—以计价货币表示的最新价格（除非另有说明，为 USD 或 USDT）。
bins[].sidestring—`long` / `short` 或 `buy` / `sell`。
bins[].tiersobject—规模分层。
bins[].tiers.10numberUSD该价格分档内由 10 倍杠杆仓位产生的模型估算清算名义价值；金额为零时不含该键。 可能缺失
bins[].totalnumber—总数。
bins[].tiers.25numberUSD该价格分档内由 25 倍杠杆仓位产生的模型估算清算名义价值；金额为零时不含该键。 可能缺失
cumarray—累计曲线，与 `bins` 按索引一一对应。
cum[]numberUSD从当前价格累计到该分档的模型估算清算名义价值（下方分档向下累计，上方分档向上累计）。
maxBinnumberUSD清算地图中最大的 `bins[].total`，可用于设定图表坐标轴的刻度范围。
totalLongnumber—多头合计。
totalShortnumber—空头合计。
actualLiq24hnumberUSD该币种最近 24 小时内实际爆仓的名义价值（多头 + 空头，来自已记录的爆仓单），用于与模型对比。

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

响应示例

/api/liq-map?symbol=BTC&range=1d · 真实响应，采集于 2026-11-13 03:52:47 UTC。 为便于展示，较长的数组和映射已被截短：cum 原有 200 项; bins 原有 200 项。

  • {
    • "symbol": "BTC",
    • "range": "1d",
    • "updatedAt": 1794541891278,
    • "currentPrice": 69059.1,
    • "binWidth": 69.0591,
    • "leverages": [
      • 10,
      • 25,
      • 50,
      • 100
      ],
    • "bins": [
      • { … 4 },
      • { … 4 }
      ],
    • "cum": [
      • 181751104,
      • 181751104,
      • 181751104,
      • 181751104,
      • 165607035,
      • 165607035,
      • 165607035,
      • 165607035
      ],
    • "maxBin": 22547138,
    • "totalLong": 181751104,
    • "totalShort": 232458129,
    • "actualLiq24h": 745954159
    }

已验证的样本

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

参数HTTP延迟结果
range=1d&symbol=ETH2001 ms通过
range=1d&symbol=SOL2001 ms通过

检查于 2026-11-13 03:28:04 UTC

详细信息

身份验证
无。公开端点。
速率限制
每个 IP 每分钟 1200 次请求
服务端缓存
60s
边缘微缓存
10s
更新频率
前 100 个币种每 5 分钟；排名 101-300 的币种分 5 个错峰批次刷新（约每 25 分钟一次）
时间窗口
range 参数：1d | 7d（假定仓位在最近 1 天或 7 天内开仓）；最新的模型快照
数据来源
模型估算值，由 CoinBoss 根据自有的小时级合约 K 线（binance，okx 为备用）、聚合持仓量历史和已采集的爆仓数据自行计算。
交易所覆盖范围
按合约名义成交额排名的最多 300 个加密货币，要求最近 7 天内爆仓事件 >= 30 次；不含代币化股票、商品、外汇和指数；估算值属于模型输出，并非交易所上报的清算价位
单位
estimated liquidation notional in USD per price level; prices in USD; timestamps in Unix ms
计算方法
each 1 h candle opens notional proportional to volume x close (boosted by OI increase), spread over leverage tiers; long liq price ~ P x (1 - 1/L + MMR), short ~ P x (1 + 1/L - MMR); levels swept by later candles are cleared; output = cumulative long/short liquidation notional by price and leverage tier
时间戳
除非字段说明另有注明，均为 Unix 纪元毫秒（UTC）
响应格式
json
稳定性
稳定

实时状态

可用检查于 2026-11-13 03:52:47 UTCHTTP 2002 ms结构一致最新数据点距今 76s

近 30 天可用性

409 次检查中 100% 通过

错误

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

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

试一试

GET/api/liq-map可用
参数

string · 默认 BTC — Coin symbol; 404 when no data.

string · 默认 1d — Time window.

请求 URLhttps://www.coinboss.com/api/liq-map?symbol=BTC&range=1d
选择一个端点，然后点击“发送请求”。响应、响应头和耗时将显示在这里。